001: /*
002:
003: ============================================================================
004: The Apache Software License, Version 1.1
005: ============================================================================
006:
007: Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.
008:
009: Redistribution and use in source and binary forms, with or without modifica-
010: tion, are permitted provided that the following conditions are met:
011:
012: 1. Redistributions of source code must retain the above copyright notice,
013: this list of conditions and the following disclaimer.
014:
015: 2. Redistributions in binary form must reproduce the above copyright notice,
016: this list of conditions and the following disclaimer in the documentation
017: and/or other materials provided with the distribution.
018:
019: 3. The end-user documentation included with the redistribution, if any, must
020: include the following acknowledgment: "This product includes software
021: developed by the Apache Software Foundation (http://www.apache.org/)."
022: Alternately, this acknowledgment may appear in the software itself, if
023: and wherever such third-party acknowledgments normally appear.
024:
025: 4. The names "Batik" and "Apache Software Foundation" must not be
026: used to endorse or promote products derived from this software without
027: prior written permission. For written permission, please contact
028: apache@apache.org.
029:
030: 5. Products derived from this software may not be called "Apache", nor may
031: "Apache" appear in their name, without prior written permission of the
032: Apache Software Foundation.
033:
034: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
035: INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
036: FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
037: APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
038: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
039: DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
040: OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
041: ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
042: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
043: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
044:
045: This software consists of voluntary contributions made by many individuals
046: on behalf of the Apache Software Foundation. For more information on the
047: Apache Software Foundation, please see <http://www.apache.org/>.
048:
049: */
050:
051: package org.apache.batik.css.engine.sac;
052:
053: import java.util.Set;
054:
055: import org.w3c.css.sac.Selector;
056: import org.w3c.dom.Element;
057:
058: /**
059: * This interface extends the {@link org.w3c.css.sac.Selector}.
060: *
061: * @author <a href="mailto:stephane@hillion.org">Stephane Hillion</a>
062: * @version $Id$
063: */
064: public interface ExtendedSelector extends Selector {
065:
066: /**
067: * Tests whether this selector matches the given element.
068: */
069: boolean match(Element e, String pseudoE);
070:
071: /**
072: * Returns the specificity of this selector.
073: */
074: int getSpecificity();
075:
076: /**
077: * Fills the given set with the attribute names found in this selector.
078: */
079: void fillAttributeSet(Set attrSet);
080:
081: // BEGIN RAVE MODIFICATIONS
082: /** Set the rule associated with this selector.
083: * Note: this means that the selector cannot be shared by multiple
084: * rules. That is not the case today anyway.
085: * This was added as part of the performance optimization where I split up
086: * the ruleset in a stylesheet and store rules associated with certain tag names,
087: * rules associated with classnames, etc. I don't want to store the actual -rules-
088: * with these maps, since the rules include the full selector lists; and when
089: * I match rules for an element (the performance sensitive computation) I don't
090: * want to check the full selector LIST for an element, only a particular selector
091: * that is stored in the map. Thus, rather than having multiple maps I'm simply
092: * storing selectors directly in the maps, and having the selectors map back to
093: * the rules.
094: */
095: void setRule(org.apache.batik.css.engine.Rule r);
096:
097: /** Get the rule assocaited with this selector.
098: */
099: org.apache.batik.css.engine.Rule getRule();
100: // END RAVE MODIFICATIONS
101: }
|