com.gargoylesoftware.css.parser

Class AbstractCSSParser

java.lang.Object

com.gargoylesoftware.css.parser.AbstractCSSParser

All Implemented Interfaces:

CSSParser

public abstract class AbstractCSSParser
extends Object
implements CSSParser

Base implementation of CSSParser.

Author:

Ronald Brill

Constructor Summary

Constructors

Constructor and Description
AbstractCSSParser()

Method Summary

Modifier and Type	Method and Description
protected String	addEscapes(String str) Escapes some chars in the given string.
protected Locator	createLocator(com.gargoylesoftware.css.parser.javacc.Token t) Returns a new locator for the given token.
protected CSSParseException	createSkipWarning(String messageKey, CSSParseException e)
protected double	doubleValue(char op, String s) Parses the sting into an double.
protected abstract LexicalUnit	expr() Process an expression.
protected LexicalUnit	functionInternal(LexicalUnit prev, String funct, LexicalUnit params) Process a function decl.
protected DocumentHandler	getDocumentHandler()
protected CSSErrorHandler	getErrorHandler()
protected InputSource	getInputSource()
protected int	getLastNumPos(String s) Returns the pos of the last numeric char in the given string.
protected String	getParserMessage(String key)
abstract String	getParserVersion()
protected void	handleCharset(String characterEncoding, Locator locator) charset handler.
protected void	handleEndDocument() end document handler.
protected void	handleEndFontFace() end font face handler.
protected void	handleEndMedia(MediaQueryList media) end media handler.
protected void	handleEndPage(String name, String pseudoPage) end page handler.
protected void	handleEndSelector(SelectorList selectors) selector end handler.
protected void	handleIgnorableAtRule(String s, Locator locator) ignorable at rule handler.
protected void	handleImportStyle(String uri, MediaQueryList media, String defaultNamespaceURI, Locator locator) import style handler.
protected void	handleMedium(String medium, Locator locator) medium handler.
protected void	handleProperty(String name, LexicalUnit value, boolean important, Locator locator) property handler.
protected void	handleStartDocument() start document handler.
protected void	handleStartFontFace(Locator locator) start font face handler.
protected void	handleStartMedia(MediaQueryList media, Locator locator) start media handler.
protected void	handleStartPage(String name, String pseudoPage, Locator locator) start page handler.
protected void	handleStartSelector(SelectorList selectors, Locator locator) selector start handler.
protected LexicalUnit	hexcolorInternal(LexicalUnit prev, com.gargoylesoftware.css.parser.javacc.Token t) Processes a hexadecimal color definition.
protected int	intValue(char op, String s) Parses the sting into an integer.
boolean	isIeStarHackAccepted()
protected abstract void	mediaList(MediaQueryList ml) Process a media list.
MediaQueryList	parseMedia(InputSource source) Parse the given input source and return the media list.
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.
protected abstract SelectorList	parseSelectorsInternal() Process a selector list.
void	parseStyleDeclaration(InputSource source) Parse a CSS style declaration (without '{' and '}').
void	parseStyleSheet(InputSource source) Parse a CSS document.
protected abstract boolean	prio() Process a prio.
protected abstract void	ReInit(com.gargoylesoftware.css.parser.javacc.CharStream charStream) Re intit the stream.
void	setDocumentHandler(DocumentHandler handler) Allow an application to register a document event handler.
void	setErrorHandler(CSSErrorHandler eh) Allow an application to register an error event handler.
void	setIeStarHackAccepted(boolean accepted)
protected abstract void	styleDeclaration() Process a style sheet declaration.
protected abstract void	styleSheet() Process a style sheet.
protected abstract void	styleSheetRuleSingle() Process a style sheet rule.
protected CSSParseException	toCSSParseException(DOMException e)
protected CSSParseException	toCSSParseException(String messageKey, Object[] msgParams, Locator locator)
protected CSSParseException	toCSSParseException(String key, com.gargoylesoftware.css.parser.javacc.ParseException e)
protected CSSParseException	toCSSParseException(com.gargoylesoftware.css.parser.javacc.TokenMgrError e)
String	unescape(String s, boolean unescapeDoubleQuotes) Unescapes escaped characters in the specified string, according to the CSS specification.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCSSParser

public AbstractCSSParser()

Method Detail

getDocumentHandler

protected DocumentHandler getDocumentHandler()

Returns:

the document handler

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)

Description copied from interface: CSSParser

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 CSSParser

Parameters:

handler - The document handler.

See Also:

DocumentHandler

getErrorHandler

protected CSSErrorHandler getErrorHandler()

Returns:

the error handler

setErrorHandler

public void setErrorHandler(CSSErrorHandler eh)

Description copied from interface: CSSParser

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 CSSParser

Parameters:

eh - The error handler.

See Also:

CSSErrorHandler, CSSException

getInputSource

protected InputSource getInputSource()

Returns:

the input source

setIeStarHackAccepted

public void setIeStarHackAccepted(boolean accepted)

Specified by:

setIeStarHackAccepted in interface CSSParser

Parameters:

accepted - trur if the parser should accept ie star hack

isIeStarHackAccepted

public boolean isIeStarHackAccepted()

Specified by:

isIeStarHackAccepted in interface CSSParser

Returns:

accepted trur if the parser should accept ie star hack

getParserMessage

protected String getParserMessage(String key)

Parameters:

key - the lookup key

Returns:

the parser message

createLocator

protected Locator createLocator(com.gargoylesoftware.css.parser.javacc.Token t)

Returns a new locator for the given token.

Parameters:

t - the token to generate the locator for

Returns:

a new locator

addEscapes

protected String addEscapes(String str)

Escapes some chars in the given string.

Parameters:

str - the input

Returns:

a new string with the escaped values

toCSSParseException

protected CSSParseException toCSSParseException(String key,
                                                com.gargoylesoftware.css.parser.javacc.ParseException e)

Parameters:

key - the message lookup key

e - the parse exception

Returns:

a new CSSParseException

toCSSParseException

protected CSSParseException toCSSParseException(DOMException e)

Parameters:

e - the DOMException

Returns:

a new CSSParseException

toCSSParseException

protected CSSParseException toCSSParseException(com.gargoylesoftware.css.parser.javacc.TokenMgrError e)

Parameters:

e - the TokenMgrError

Returns:

a new CSSParseException

toCSSParseException

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

Parameters:

messageKey - the message key

msgParams - the params

locator - the locator

Returns:

a new CSSParseException

createSkipWarning

protected CSSParseException createSkipWarning(String messageKey,
                                              CSSParseException e)

Parameters:

messageKey - the message key

e - a CSSParseException

Returns:

a new CSSParseException

parseStyleSheet

public void parseStyleSheet(InputSource source)
                     throws IOException

Description copied from interface: CSSParser

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 CSSParser

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, CSSParser.setDocumentHandler(com.gargoylesoftware.css.parser.DocumentHandler), CSSParser.setErrorHandler(com.gargoylesoftware.css.parser.CSSErrorHandler)

parseStyleDeclaration

public void parseStyleDeclaration(InputSource source)
                           throws IOException

Description copied from interface: CSSParser

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

Specified by:

parseStyleDeclaration in interface CSSParser

Parameters:

source - source to be parsed

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: CSSParser

Parse a CSS rule.

Specified by:

parseRule in interface CSSParser

Parameters:

source - source to be parsed

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: CSSParser

Parse a comma separated list of selectors.

Specified by:

parseSelectors in interface CSSParser

Parameters:

source - source to be parsed

Returns:

a selector list

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: CSSParser

Parse a CSS property value.

Specified by:

parsePropertyValue in interface CSSParser

Parameters:

source - source to be parsed

Returns:

a lexical unit

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: CSSParser

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

Specified by:

parsePriority in interface CSSParser

Parameters:

source - source to be parsed

Returns:

true or flase

Throws:

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

parseMedia

public MediaQueryList parseMedia(InputSource source)
                          throws IOException

Parse the given input source and return the media list.

Parameters:

source - the input source

Returns:

new media list

Throws:

IOException - in case of errors

getParserVersion

public abstract String getParserVersion()

Specified by:

getParserVersion in interface CSSParser

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.

ReInit

protected abstract void ReInit(com.gargoylesoftware.css.parser.javacc.CharStream charStream)

Re intit the stream.

Parameters:

charStream - the stream

styleSheet

protected abstract void styleSheet()
                            throws CSSParseException,
                                   com.gargoylesoftware.css.parser.javacc.ParseException

Process a style sheet.

Throws:

CSSParseException - in case of error

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

styleDeclaration

protected abstract void styleDeclaration()
                                  throws com.gargoylesoftware.css.parser.javacc.ParseException

Process a style sheet declaration.

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

styleSheetRuleSingle

protected abstract void styleSheetRuleSingle()
                                      throws com.gargoylesoftware.css.parser.javacc.ParseException

Process a style sheet rule.

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

parseSelectorsInternal

protected abstract SelectorList parseSelectorsInternal()
                                                throws com.gargoylesoftware.css.parser.javacc.ParseException

Process a selector list.

Returns:

the selector list

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

expr

protected abstract LexicalUnit expr()
                             throws com.gargoylesoftware.css.parser.javacc.ParseException

Process an expression.

Returns:

the lexical unit

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

prio

protected abstract boolean prio()
                         throws com.gargoylesoftware.css.parser.javacc.ParseException

Process a prio.

Returns:

true or false

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

mediaList

protected abstract void mediaList(MediaQueryList ml)
                           throws com.gargoylesoftware.css.parser.javacc.ParseException

Process a media list.

Parameters:

ml - the media list

Throws:

com.gargoylesoftware.css.parser.javacc.ParseException - in case of error

handleStartDocument

protected void handleStartDocument()

start document handler.

handleEndDocument

protected void handleEndDocument()

end document handler.

handleIgnorableAtRule

protected void handleIgnorableAtRule(String s,
                                     Locator locator)

ignorable at rule handler.

Parameters:

s - the rule

locator - the locator

handleCharset

protected void handleCharset(String characterEncoding,
                             Locator locator)

charset handler.

Parameters:

characterEncoding - the encoding

locator - the locator

handleImportStyle

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

import style handler.

Parameters:

uri - the uri

media - the media query list

defaultNamespaceURI - the namespace uri

locator - the locator

handleStartMedia

protected void handleStartMedia(MediaQueryList media,
                                Locator locator)

start media handler.

Parameters:

media - the media query list

locator - the locator

handleMedium

protected void handleMedium(String medium,
                            Locator locator)

medium handler.

Parameters:

medium - the medium

locator - the locator

handleEndMedia

protected void handleEndMedia(MediaQueryList media)

end media handler.

Parameters:

media - the media query list

handleStartPage

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

start page handler.

Parameters:

name - the name

pseudoPage - the pseudo page

locator - the locator

handleEndPage

protected void handleEndPage(String name,
                             String pseudoPage)

end page handler.

Parameters:

name - the name

pseudoPage - the pseudo page

handleStartFontFace

protected void handleStartFontFace(Locator locator)

start font face handler.

Parameters:

locator - the locator

handleEndFontFace

protected void handleEndFontFace()

end font face handler.

handleStartSelector

protected void handleStartSelector(SelectorList selectors,
                                   Locator locator)

selector start handler.

Parameters:

selectors - the selector list

locator - the locator

handleEndSelector

protected void handleEndSelector(SelectorList selectors)

selector end handler.

Parameters:

selectors - the selector list

handleProperty

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

property handler.

Parameters:

name - the name

value - the value

important - important flag

locator - the locator

functionInternal

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

Process a function decl.

Parameters:

prev - the previous lexical unit

funct - the function

params - the params

Returns:

a lexical unit

hexcolorInternal

protected LexicalUnit hexcolorInternal(LexicalUnit prev,
                                       com.gargoylesoftware.css.parser.javacc.Token t)

Processes a hexadecimal color definition.

Parameters:

prev - the previous lexical unit

t - the token

Returns:

a new lexical unit

intValue

protected int intValue(char op,
                       String s)

Parses the sting into an integer.

Parameters:

op - the sign char

s - the string to parse

Returns:

the int value

doubleValue

protected double doubleValue(char op,
                             String s)

Parses the sting into an double.

Parameters:

op - the sign char

s - the string to parse

Returns:

the double value

getLastNumPos

protected int getLastNumPos(String s)

Returns the pos of the last numeric char in the given string.

Parameters:

s - the string to parse

Returns:

the pos

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.

Parameters:

s - the string to unescape

unescapeDoubleQuotes - if true unescape double quotes also

Returns:

the unescaped string