com.steadystate.css.parser

Class SACParserCSS21

java.lang.Object

com.steadystate.css.parser.SACParserCSS21

All Implemented Interfaces:

SACParser, SACParserCSS21Constants, Parser

public class SACParserCSS21
extends Object
implements SACParserCSS21Constants

Author:

David Schweinsberg, waldbaer, rbri

Field Summary

Fields

Modifier and Type	Field and Description
Token	jj_nt Next token.
Token	token Current token.
SACParserCSS21TokenManager	token_source Generated Token Manager.

Fields inherited from interface com.steadystate.css.parser.SACParserCSS21Constants

A_LETTER, ANGLE_DEG, ANGLE_GRAD, ANGLE_RAD, ASTERISK, ATKEYWORD, C_LETTER, CDC, CDO, CHARSET_SYM, COLON, COMMA, COMMENT, COMMENT_, D_LETTER, DASHMATCH, DEFAULT, DIMENSION, DOT, E_LETTER, EMS, EOF, EQUALS, ESCAPE, EXS, FREQ_HZ, FREQ_KHZ, FUNCTION, FUNCTION_LANG, G_LETTER, GREATER, H, H_LETTER, HASH, HNUM, I_LETTER, IDENT, IMPORT_SYM, IMPORTANT_SYM, INCLUDES, INHERIT, K_LETTER, L_LETTER, LBRACE, LENGTH_CM, LENGTH_IN, LENGTH_MM, LENGTH_PC, LENGTH_PT, LENGTH_PX, LROUND, LSQUARE, M_LETTER, MEDIA_SYM, MINUS, N_LETTER, NAME, NL, NMCHAR, NMSTART, NONASCII, NUM, NUMBER, O_LETTER, P_LETTER, PAGE_SYM, PERCENTAGE, PLUS, R_LETTER, RBRACE, RROUND, RSQUARE, S, S_LETTER, SEMICOLON, SLASH, STRING, STRING1, STRING2, T_LETTER, TIME_MS, TIME_S, tokenImage, UNICODE, UNKNOWN, URI, URL, W, X_LETTER, Z_LETTER

Constructor Summary

Constructors

Constructor and Description
SACParserCSS21()
SACParserCSS21(CharStream stream) Constructor with user supplied CharStream.
SACParserCSS21(SACParserCSS21TokenManager tm) Constructor with generated Token Manager.

Method Summary

Modifier and Type	Method and Description
Condition	_class(Condition pred, boolean pseudoElementFound)
protected String	add_escapes(String str)
Condition	attrib(Condition pred, boolean pseudoElementFound)
void	charsetRule()
char	combinator()
protected Locator	createLocator(Token t)
protected CSSParseException	createSkipWarning(String key, CSSParseException e)
void	declaration()
void	disable_tracing() Disable tracing.
SimpleSelector	elementName()
void	enable_tracing() Enable tracing.
LexicalUnit	expr()
LexicalUnit	function(LexicalUnit prev)
protected LexicalUnit	functionInternal(LexicalUnit prev, String funct, LexicalUnit params)
ParseException	generateParseException() Generate ParseException.
protected ConditionFactoryExt	getConditionFactory()
protected DocumentHandlerExt	getDocumentHandler()
protected ErrorHandler	getErrorHandler()
protected String	getGrammarUri()
protected InputSource	getInputSource()
protected Locale	getLocale()
Token	getNextToken() Get the next Token.
String	getParserVersion() Returns a string about which CSS language is supported by this parser.
protected ResourceBundle	getSACParserMessages()
protected SelectorFactoryExt	getSelectorFactory()
Token	getToken(int index) Get the specific Token.
protected void	handleCharset(String characterEncoding, Locator locator)
protected void	handleEndDocument()
protected void	handleEndFontFace()
protected void	handleEndMedia(SACMediaList media)
protected void	handleEndPage(String name, String pseudoPage)
protected void	handleEndSelector(SelectorList selectors)
protected void	handleIgnorableAtRule(String s, Locator locator)
protected void	handleImportStyle(String uri, SACMediaList media, String defaultNamespaceURI, Locator locator)
protected void	handleMedium(String medium, Locator locator)
protected void	handleProperty(String name, LexicalUnit value, boolean important, Locator locator)
protected void	handleSelector(Selector selector)
protected void	handleStartDocument()
protected void	handleStartFontFace(Locator locator)
protected void	handleStartMedia(SACMediaList media, Locator locator)
protected void	handleStartPage(String name, String pseudoPage, Locator locator)
protected void	handleStartSelector(SelectorList selectors, Locator locator)
Condition	hash(Condition pred, boolean pseudoElementFound)
LexicalUnit	hexcolor(LexicalUnit prev)
protected LexicalUnit	hexcolorInternal(LexicalUnit prev, Token t)
void	importRule(boolean nonImportRuleFoundBefore)
boolean	isIeStarHackAccepted()
void	mediaList(SACMediaListImpl ml)
void	mediaRule()
void	mediaRuleList()
String	medium()
LexicalUnit	operator(LexicalUnit prev)
void	pageRule()
SACMediaList	parseMedia(InputSource source)
boolean	parsePriority(InputSource source) Parse a CSS priority value (e.g. "!
LexicalUnit	parsePropertyValue(InputSource source) Parse a CSS property value.
void	parseRule(InputSource source) Parse a CSS rule.
SelectorList	parseSelectors(InputSource source) Parse a comma separated list of selectors.
SelectorList	parseSelectorsInternal()
void	parseStyleDeclaration(InputSource source) Parse a CSS style declaration (without '{' and '}').
void	parseStyleSheet(InputSource source) Parse a CSS document.
void	parseStyleSheet(String uri) Parse a CSS document from a URI.
boolean	prio()
String	property()
Object	pseudo(Condition pred, boolean pseudoElementFound)
String	pseudoPage()
void	ReInit(CharStream stream) Reinitialise.
void	ReInit(SACParserCSS21TokenManager tm) Reinitialise.
Selector	selector()
SelectorList	selectorList()
void	setConditionFactory(ConditionFactory conditionFactory)
void	setDocumentHandler(DocumentHandler handler) Allow an application to register a document event handler.
void	setErrorHandler(ErrorHandler eh) Allow an application to register an error event handler.
void	setIeStarHackAccepted(boolean accepted)
void	setLocale(Locale locale) Allow an application to request a locale for errors and warnings.
void	setSelectorFactory(SelectorFactory selectorFactory)
Selector	simpleSelector(Selector sel, char comb)
void	styleDeclaration()
void	styleRule()
void	styleSheet()
void	styleSheetRuleList()
void	styleSheetRuleSingle()
LexicalUnit	term(LexicalUnit prev)
protected CSSParseException	toCSSParseException(DOMException e)
protected CSSParseException	toCSSParseException(String messageKey, Object[] msgParams, Locator locator)
protected CSSParseException	toCSSParseException(String key, ParseException e)
protected CSSParseException	toCSSParseException(TokenMgrError e)
boolean	trace_enabled() Trace enabled.
char	unaryOperator()
String	unescape(String s, boolean unescapeDoubleQuotes) Unescapes escaped characters in the specified string, according to the CSS specification.
void	unknownAtRule()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

token_source

public SACParserCSS21TokenManager token_source

Generated Token Manager.

token

public Token token

Current token.

jj_nt

public Token jj_nt

Next token.

Constructor Detail

SACParserCSS21

public SACParserCSS21()

SACParserCSS21

public SACParserCSS21(CharStream stream)

Constructor with user supplied CharStream.

SACParserCSS21

public SACParserCSS21(SACParserCSS21TokenManager tm)

Constructor with generated Token Manager.

Method Detail

getParserVersion

public String getParserVersion()

Description copied from interface: Parser

Returns a string about which CSS language is supported by this parser. For CSS Level 1, it returns "http://www.w3.org/TR/REC-CSS1", for CSS Level 2, it returns "http://www.w3.org/TR/REC-CSS2". Note that a "CSSx" parser can return lexical unit other than those allowed by CSS Level x but this usage is not recommended.

Specified by:

getParserVersion in interface Parser

getGrammarUri

protected String getGrammarUri()

styleSheet

public final void styleSheet()
                      throws ParseException

Throws:

ParseException

styleSheetRuleList

public final void styleSheetRuleList()
                              throws ParseException

Throws:

ParseException

styleSheetRuleSingle

public final void styleSheetRuleSingle()
                                throws ParseException

Throws:

ParseException

charsetRule

public final void charsetRule()
                       throws ParseException

Throws:

ParseException

unknownAtRule

public final void unknownAtRule()
                         throws ParseException

Throws:

ParseException

importRule

public final void importRule(boolean nonImportRuleFoundBefore)
                      throws ParseException

Throws:

ParseException

mediaRule

public final void mediaRule()
                     throws ParseException

Throws:

ParseException

mediaList

public final void mediaList(SACMediaListImpl ml)
                     throws ParseException

Throws:

ParseException

mediaRuleList

public final void mediaRuleList()
                         throws ParseException

Throws:

ParseException

medium

public final String medium()
                    throws ParseException

Throws:

ParseException

pageRule

public final void pageRule()
                    throws ParseException

Throws:

ParseException

pseudoPage

public final String pseudoPage()
                        throws ParseException

Throws:

ParseException

operator

public final LexicalUnit operator(LexicalUnit prev)
                           throws ParseException

Throws:

ParseException

combinator

public final char combinator()
                      throws ParseException

Throws:

ParseException

unaryOperator

public final char unaryOperator()
                         throws ParseException

Throws:

ParseException

property

public final String property()
                      throws ParseException

Throws:

ParseException

styleRule

public final void styleRule()
                     throws ParseException

Throws:

ParseException

parseSelectorsInternal

public final SelectorList parseSelectorsInternal()
                                          throws ParseException

Throws:

ParseException

selectorList

public final SelectorList selectorList()
                                throws ParseException

Throws:

ParseException

selector

public final Selector selector()
                        throws ParseException

Throws:

ParseException

simpleSelector

public final Selector simpleSelector(Selector sel,
                                     char comb)
                              throws ParseException

Throws:

ParseException

_class

public final Condition _class(Condition pred,
                              boolean pseudoElementFound)
                       throws ParseException

Throws:

ParseException

elementName

public final SimpleSelector elementName()
                                 throws ParseException

Throws:

ParseException

attrib

public final Condition attrib(Condition pred,
                              boolean pseudoElementFound)
                       throws ParseException

Throws:

ParseException

pseudo

public final Object pseudo(Condition pred,
                           boolean pseudoElementFound)
                    throws ParseException

Throws:

ParseException

hash

public final Condition hash(Condition pred,
                            boolean pseudoElementFound)
                     throws ParseException

Throws:

ParseException

styleDeclaration

public final void styleDeclaration()
                            throws ParseException

Throws:

ParseException

declaration

public final void declaration()
                       throws ParseException

Throws:

ParseException

prio

public final boolean prio()
                   throws ParseException

Throws:

ParseException

expr

public final LexicalUnit expr()
                       throws ParseException

Throws:

ParseException

term

public final LexicalUnit term(LexicalUnit prev)
                       throws ParseException

Throws:

ParseException

function

public final LexicalUnit function(LexicalUnit prev)
                           throws ParseException

Throws:

ParseException

hexcolor

public final LexicalUnit hexcolor(LexicalUnit prev)
                           throws ParseException

Throws:

ParseException

ReInit

public void ReInit(CharStream stream)

Reinitialise.

ReInit

public void ReInit(SACParserCSS21TokenManager tm)

Reinitialise.

getNextToken

public final Token getNextToken()

Get the next Token.

getToken

public final Token getToken(int index)

Get the specific Token.

generateParseException

public ParseException generateParseException()

Generate ParseException.

trace_enabled

public final boolean trace_enabled()

Trace enabled.

enable_tracing

public final void enable_tracing()

Enable tracing.

disable_tracing

public final void disable_tracing()

Disable tracing.

getDocumentHandler

protected DocumentHandlerExt getDocumentHandler()

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)

Description copied from interface: Parser

Allow an application to register a document event handler.

If the application does not register a document handler, all document events reported by the CSS parser will be silently ignored (this is the default behaviour implemented by HandlerBase).

Applications may register a new or different handler in the middle of a parse, and the CSS parser must begin using the new handler immediately.

Specified by:

setDocumentHandler in interface Parser

Parameters:

handler - The document handler.

See Also:

DocumentHandler

getErrorHandler

protected ErrorHandler getErrorHandler()

setErrorHandler

public void setErrorHandler(ErrorHandler eh)

Description copied from interface: Parser

Allow an application to register an error event handler.

If the application does not register an error event handler, all error events reported by the CSS parser will be silently ignored, except for fatalError, which will throw a CSSException (this is the default behaviour implemented by HandlerBase).

Applications may register a new or different handler in the middle of a parse, and the CSS parser must begin using the new handler immediately.

Specified by:

setErrorHandler in interface Parser

Parameters:

eh - The error handler.

See Also:

ErrorHandler, CSSException

getInputSource

protected InputSource getInputSource()

setIeStarHackAccepted

public void setIeStarHackAccepted(boolean accepted)

Specified by:

setIeStarHackAccepted in interface SACParser

isIeStarHackAccepted

public boolean isIeStarHackAccepted()

Specified by:

isIeStarHackAccepted in interface SACParser

setLocale

public void setLocale(Locale locale)

Description copied from interface: Parser

Allow an application to request a locale for errors and warnings.

CSS parsers are not required to provide localisation for errors and warnings; if they cannot support the requested locale, however, they must throw a CSS exception. Applications may not request a locale change in the middle of a parse.

Specified by:

setLocale in interface Parser

Parameters:

locale - A Java Locale object.

See Also:

CSSException, CSSParseException

getLocale

protected Locale getLocale()

getSelectorFactory

protected SelectorFactoryExt getSelectorFactory()

setSelectorFactory

public void setSelectorFactory(SelectorFactory selectorFactory)

Specified by:

setSelectorFactory in interface Parser

getConditionFactory

protected ConditionFactoryExt getConditionFactory()

setConditionFactory

public void setConditionFactory(ConditionFactory conditionFactory)

Specified by:

setConditionFactory in interface Parser

getSACParserMessages

protected ResourceBundle getSACParserMessages()

createLocator

protected Locator createLocator(Token t)

add_escapes

protected String add_escapes(String str)

toCSSParseException

protected CSSParseException toCSSParseException(String key,
                                                ParseException e)

toCSSParseException

protected CSSParseException toCSSParseException(DOMException e)

toCSSParseException

protected CSSParseException toCSSParseException(TokenMgrError e)

toCSSParseException

protected CSSParseException toCSSParseException(String messageKey,
                                                Object[] msgParams,
                                                Locator locator)

createSkipWarning

protected CSSParseException createSkipWarning(String key,
                                              CSSParseException e)

parseStyleSheet

public void parseStyleSheet(InputSource source)
                     throws IOException

Description copied from interface: Parser

Parse a CSS document.

The application can use this method to instruct the CSS parser to begin parsing an CSS document from any valid input source (a character stream, a byte stream, or a URI).

Applications may not invoke this method while a parse is in progress (they should create a new Parser instead for each additional CSS document). Once a parse is complete, an application may reuse the same Parser object, possibly with a different input source.

Specified by:

parseStyleSheet in interface Parser

Parameters:

source - The input source for the top-level of the CSS document.

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

See Also:

InputSource, Parser.parseStyleSheet(java.lang.String), Parser.setDocumentHandler(org.w3c.css.sac.DocumentHandler), Parser.setErrorHandler(org.w3c.css.sac.ErrorHandler)

parseStyleSheet

public void parseStyleSheet(String uri)
                     throws IOException

Description copied from interface: Parser

Parse a CSS document from a URI.

This method is a shortcut for the common case of reading a document from a URI. It is the exact equivalent of the following:

 parse(new InputSource(uri));
 

The URI must be fully resolved by the application before it is passed to the parser.

Specified by:

parseStyleSheet in interface Parser

Parameters:

uri - The URI.

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

See Also:

Parser.parseStyleSheet(InputSource)

parseStyleDeclaration

public void parseStyleDeclaration(InputSource source)
                           throws IOException

Description copied from interface: Parser

Parse a CSS style declaration (without '{' and '}').

Specified by:

parseStyleDeclaration in interface Parser

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

parseRule

public void parseRule(InputSource source)
               throws IOException

Description copied from interface: Parser

Parse a CSS rule.

Specified by:

parseRule in interface Parser

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

parseSelectors

public SelectorList parseSelectors(InputSource source)
                            throws IOException

Description copied from interface: Parser

Parse a comma separated list of selectors.

Specified by:

parseSelectors in interface Parser

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

parsePropertyValue

public LexicalUnit parsePropertyValue(InputSource source)
                               throws IOException

Description copied from interface: Parser

Parse a CSS property value.

Specified by:

parsePropertyValue in interface Parser

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

parsePriority

public boolean parsePriority(InputSource source)
                      throws IOException

Description copied from interface: Parser

Parse a CSS priority value (e.g. "!important").

Specified by:

parsePriority in interface Parser

Throws:

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.

parseMedia

public SACMediaList parseMedia(InputSource source)
                        throws IOException

Throws:

IOException

handleStartDocument

protected void handleStartDocument()

handleEndDocument

protected void handleEndDocument()

handleIgnorableAtRule

protected void handleIgnorableAtRule(String s,
                                     Locator locator)

handleCharset

protected void handleCharset(String characterEncoding,
                             Locator locator)

handleImportStyle

protected void handleImportStyle(String uri,
                                 SACMediaList media,
                                 String defaultNamespaceURI,
                                 Locator locator)

handleStartMedia

protected void handleStartMedia(SACMediaList media,
                                Locator locator)

handleMedium

protected void handleMedium(String medium,
                            Locator locator)

handleEndMedia

protected void handleEndMedia(SACMediaList media)

handleStartPage

protected void handleStartPage(String name,
                               String pseudoPage,
                               Locator locator)

handleEndPage

protected void handleEndPage(String name,
                             String pseudoPage)

handleStartFontFace

protected void handleStartFontFace(Locator locator)

handleEndFontFace

protected void handleEndFontFace()

handleSelector

protected void handleSelector(Selector selector)

handleStartSelector

protected void handleStartSelector(SelectorList selectors,
                                   Locator locator)

handleEndSelector

protected void handleEndSelector(SelectorList selectors)

handleProperty

protected void handleProperty(String name,
                              LexicalUnit value,
                              boolean important,
                              Locator locator)

functionInternal

protected LexicalUnit functionInternal(LexicalUnit prev,
                                       String funct,
                                       LexicalUnit params)

hexcolorInternal

protected LexicalUnit hexcolorInternal(LexicalUnit prev,
                                       Token t)

unescape

public String unescape(String s,
                       boolean unescapeDoubleQuotes)

Unescapes escaped characters in the specified string, according to the CSS specification. This could be done directly in the parser, but portions of the lexer would have to be moved to the parser, meaning that the grammar would no longer match the standard grammar specified by the W3C. This would make the parser and lexer much less maintainable.

Specified by:

unescape in interface SACParser