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.parser;
052:
053: import java.io.IOException;
054:
055: import org.w3c.css.sac.CSSException;
056: import org.w3c.css.sac.LexicalUnit;
057: import org.w3c.css.sac.SACMediaList;
058: import org.w3c.css.sac.SelectorList;
059:
060: /**
061: * This class implements the {@link org.w3c.css.sac.Parser} interface plus a
062: * set of custom methods.
063: *
064: * @author <a href="mailto:stephane@hillion.org">Stephane Hillion</a>
065: * @version $Id$
066: */
067: public interface ExtendedParser extends org.w3c.css.sac.Parser {
068:
069: /**
070: * Parse a CSS style declaration (without '{' and '}').
071: *
072: * @param styleValue The declaration.
073: * @exception CSSException Any CSS exception, possibly
074: * wrapping another exception.
075: * @exception java.io.IOException An IO exception from the parser,
076: * possibly from a byte stream or character stream
077: * supplied by the application.
078: */
079: void parseStyleDeclaration(String source) throws CSSException,
080: IOException;
081:
082: /**
083: * Parse a CSS rule.
084: *
085: * @exception CSSException Any CSS exception, possibly
086: * wrapping another exception.
087: * @exception java.io.IOException An IO exception from the parser,
088: * possibly from a byte stream or character stream
089: * supplied by the application.
090: */
091: void parseRule(String source) throws CSSException, IOException;
092:
093: /**
094: * Parse a comma separated list of selectors.
095: *
096: *
097: * @exception CSSException Any CSS exception, possibly
098: * wrapping another exception.
099: * @exception java.io.IOException An IO exception from the parser,
100: * possibly from a byte stream or character stream
101: * supplied by the application.
102: */
103: SelectorList parseSelectors(String source) throws CSSException,
104: IOException;
105:
106: /**
107: * Parse a CSS property value.
108: *
109: *
110: * @exception CSSException Any CSS exception, possibly
111: * wrapping another exception.
112: * @exception java.io.IOException An IO exception from the parser,
113: * possibly from a byte stream or character stream
114: * supplied by the application.
115: */
116: LexicalUnit parsePropertyValue(String source) throws CSSException,
117: IOException;
118:
119: /**
120: * Parse a CSS media value.
121: *
122: *
123: * @exception CSSException Any CSS exception, possibly
124: * wrapping another exception.
125: * @exception java.io.IOException An IO exception from the parser,
126: * possibly from a byte stream or character stream
127: * supplied by the application.
128: */
129: SACMediaList parseMedia(String mediaText) throws CSSException,
130: IOException;
131:
132: /**
133: * Parse a CSS priority value (e.g. "!important").
134: *
135: *
136: * @exception CSSException Any CSS exception, possibly
137: * wrapping another exception.
138: * @exception java.io.IOException An IO exception from the parser,
139: * possibly from a byte stream or character stream
140: * supplied by the application.
141: */
142: boolean parsePriority(String source) throws CSSException,
143: IOException;
144:
145: // BEGIN RAVE MODIFICATIONS
146: /**
147: * Get the line number of the associated scanner
148: */
149: int getLine();
150:
151: int getColumn();
152:
153: // END RAVE MODIFICATIONS
154: }
|