Module io.sf.carte.css4j

Package io.sf.carte.doc.style.css.parser

Class CSSParser

java.lang.Object

io.sf.carte.doc.style.css.parser.CSSParser

All Implemented Interfaces:

Parser2, Parser

public class CSSParser
extends Object
implements Parser2

CSS parser implementing the NSAC API.

Additionally to NSAC, it adds a few methods to parse media queries, @supports conditions and the bodies of other rules (you probably want to use them through the Object Model instead of calling them directly).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CSSParser.DeclarationRuleHandler	Small extension to SAC's DocumentHandler to deal with declaration rules.

Nested classes/interfaces inherited from interface io.sf.carte.doc.style.css.nsac.Parser2

Parser2.Flag, Parser2.NamespaceMap

Constructor Summary

Constructors

Constructor	Description
CSSParser()

Method Summary

Modifier and Type	Method	Description
String	getParserVersion()
void	parseDeclarationRule(InputSource source)
void	parseFontFeatureValuesBody(String blockList)
void	parseKeyFramesBody(String blockList)
void	parseMediaQuery(String media, MediaConditionFactory condFactory, MediaQueryHandler mqhandler)	Parse a media query.
boolean	parsePriority(InputSource source)
LexicalUnit2	parsePropertyValue(String propertyName, Reader reader)
LexicalUnit2	parsePropertyValue(InputSource source)
void	parseRule(InputSource source)
void	parseRule(InputSource source, Parser2.NamespaceMap nsmap)	Parse a CSS rule.
SelectorList	parseSelectors(String seltext)
SelectorList	parseSelectors(InputSource source)
void	parseStyleDeclaration(InputSource source)
void	parseStyleSheet(String uri)
void	parseStyleSheet(InputSource source)
BooleanCondition	parseSupportsCondition(String conditionText, ExtendedCSSRule rule)	Parse the condition text of a @supports rule.
void	setConditionFactory(ConditionFactory conditionFactory)
void	setDocumentHandler(DocumentHandler handler)
void	setErrorHandler(ErrorHandler handler)
void	setFlag(Parser2.Flag flag)	Set a parser flag.
void	setLocale(Locale locale)
void	setSelectorFactory(SelectorFactory selectorFactory)
void	setStreamSizeLimit(int streamSizeLimit)	Set a new limit for the stream size that can be processed.
void	unsetFlag(Parser2.Flag flag)	Unset a parser flag.

Methods inherited from class java.lang.Object

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

Constructor Details

CSSParser

public CSSParser()

Method Details

setLocale

public void setLocale(Locale locale)
               throws CSSException

Specified by:

setLocale in interface Parser

Throws:

CSSException

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)

Specified by:

setDocumentHandler in interface Parser

setSelectorFactory

public void setSelectorFactory(SelectorFactory selectorFactory)

Specified by:

setSelectorFactory in interface Parser

setConditionFactory

public void setConditionFactory(ConditionFactory conditionFactory)

Specified by:

setConditionFactory in interface Parser

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

Specified by:

setErrorHandler in interface Parser

setFlag

public void setFlag(Parser2.Flag flag)

Set a parser flag.

Currently only STARHACK is supported, and it only applies to the parsing of full sheets.

Specified by:

setFlag in interface Parser2

Parameters:

flag - the flag.

unsetFlag

public void unsetFlag(Parser2.Flag flag)

Unset a parser flag.

Specified by:

unsetFlag in interface Parser2

Parameters:

flag - the flag.

setStreamSizeLimit

public void setStreamSizeLimit(int streamSizeLimit)

Set a new limit for the stream size that can be processed.

Calling this method does not affect the parsing that was already ongoing.

Parameters:

streamSizeLimit - the new limit to be enforced by new processing by this parser.

Throws:

IllegalArgumentException - if a limit below 64K was used.

parseStyleSheet

public void parseStyleSheet(InputSource source)
                     throws CSSException,
IOException

Specified by:

parseStyleSheet in interface Parser

Throws:

CSSException

IOException

parseStyleSheet

public void parseStyleSheet(String uri)
                     throws CSSException,
IOException

Specified by:

parseStyleSheet in interface Parser

Throws:

CSSException

IOException

parseStyleDeclaration

public void parseStyleDeclaration(InputSource source)
                           throws CSSException,
IOException

Specified by:

parseStyleDeclaration in interface Parser

Throws:

CSSException

IOException

parseDeclarationRule

public void parseDeclarationRule(InputSource source)
                          throws CSSException,
IOException

Throws:

CSSException

IOException

parseRule

public void parseRule(InputSource source)
               throws CSSException,
IOException

Specified by:

parseRule in interface Parser

Throws:

CSSException

IOException

parseRule

public void parseRule(InputSource source,
 Parser2.NamespaceMap nsmap)
               throws CSSException,
IOException

Description copied from interface: Parser2

Parse a CSS rule.

Specified by:

parseRule in interface Parser2

Parameters:

source - the rule's source.

nsmap - the namespace map.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

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

parseKeyFramesBody

public void parseKeyFramesBody(String blockList)
                        throws CSSParseException

Throws:

CSSParseException

parseFontFeatureValuesBody

public void parseFontFeatureValuesBody(String blockList)

parseSupportsCondition

public BooleanCondition parseSupportsCondition(String conditionText,
 ExtendedCSSRule rule)
                                        throws CSSException

Parse the condition text of a @supports rule.

Parameters:

conditionText - the condition text.

rule - the rule that would process the error. if null, a problem while parsing shall result in an exception. Note that SAC_NOT_SUPPORTED_ERR exceptions are always thrown instead of being processed by the rule.

Returns:

the @supports condition, or null if a rule was specified to handle the errors, and an error was produced.

Throws:

CSSException - if there is a syntax problem and there is no error handler, or CSSException.SAC_NOT_SUPPORTED_ERR if a hard-coded limit in nested expressions was reached.

parseMediaQuery

public void parseMediaQuery(String media,
 MediaConditionFactory condFactory,
 MediaQueryHandler mqhandler)
                     throws CSSException

Parse a media query.

Parameters:

media - the media query text.

condFactory - the condition factory.

mqhandler - the media query handler.

Throws:

CSSException - CSSException.SAC_NOT_SUPPORTED_ERR if a hard-coded limit in nested expressions was reached.

getParserVersion

public String getParserVersion()

Specified by:

getParserVersion in interface Parser

parseSelectors

public SelectorList parseSelectors(InputSource source)
                            throws CSSException,
IOException

Specified by:

parseSelectors in interface Parser

Throws:

CSSException

IOException

parseSelectors

public SelectorList parseSelectors(String seltext)
                            throws CSSException

Throws:

CSSException

parsePropertyValue

public LexicalUnit2 parsePropertyValue(InputSource source)
                                throws CSSException,
IOException

Specified by:

parsePropertyValue in interface Parser

Throws:

CSSException

IOException

parsePropertyValue

public LexicalUnit2 parsePropertyValue(String propertyName,
 Reader reader)
                                throws CSSException,
IOException

Throws:

CSSException

IOException

parsePriority

public boolean parsePriority(InputSource source)
                      throws CSSException,
IOException

Specified by:

parsePriority in interface Parser

Throws:

CSSException

IOException