org.jfree.layouting.input.style.parser

Class StyleSheetHandler

public class StyleSheetHandler extends Object implements DocumentHandler, ErrorHandler

Creation-Date: 23.11.2005, 13:06:06

Author: Thomas Morgner

Constructor Summary
StyleSheetHandler()
Method Summary
voidcomment(String text)
Receive notification of a comment.
voidendDocument(InputSource source)
Receive notification of the end of a document.
voidendFontFace()
Receive notification of the end of a font face statement.
voidendMedia(SACMediaList media)
Receive notification of the end of a media statement.
voidendPage(String name, String pseudo_page)
Receive notification of the end of a media statement.
voidendSelector(SelectorList selectors)
Receive notification of the end of a rule statement.
voiderror(CSSParseException exception)
Receive notification of a recoverable error.
voidfatalError(CSSParseException exception)
Receive notification of a non-recoverable error.
StringgetDefaultNamespaceURI()
DependencyCollectorgetDependencies()
protected StyleRulegetParentRule()
ResourceManagergetResourceManager()
ResourceKeygetSource()
CSSDeclarationRulegetStyleRule()
StyleSheetgetStyleSheet()
voidignorableAtRule(String atRule)
Receive notification of an unknown rule t-rule not supported by this parser.
voidimportStyle(String uri, SACMediaList media, String defaultNamespaceURI)
Receive notification of a import statement in the style sheet.
voidinit(ResourceManager manager, ResourceKey source, long version, StyleKeyRegistry registry, StyleRule parentRule)
voidinitParseContext(InputSource source)
voidnamespaceDeclaration(String prefix, String uri)
Receive notification of an unknown rule t-rule not supported by this parser.
voidproperty(String name, LexicalUnit value, boolean important)
Receive notification of a declaration.
voidregisterNamespace(String prefix, String uri)
voidsetDefaultNamespaceURI(String defaultNamespace)
voidsetStyleRule(CSSDeclarationRule styleRule)
voidsetStyleSheet(StyleSheet styleSheet)
voidstartDocument(InputSource source)
Receive notification of the beginning of a style sheet.
voidstartFontFace()
Receive notification of the beginning of a font face statement.
voidstartMedia(SACMediaList media)
Receive notification of the beginning of a media statement.
voidstartPage(String name, String pseudo_page)
Receive notification of the beginning of a page statement.
voidstartSelector(SelectorList selectors)
Receive notification of the beginning of a rule statement.
voidwarning(CSSParseException exception)
Receive notification of a warning.

Constructor Detail

StyleSheetHandler

public StyleSheetHandler()

Method Detail

comment

public void comment(String text)
Receive notification of a comment. If the comment appears in a declaration (e.g. color: /* comment * / blue;), the parser notifies the comment before the declaration.

Parameters: text The comment.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

endDocument

public void endDocument(InputSource source)
Receive notification of the end of a document.

The CSS parser will invoke this method only once, and it will be the last method invoked during the parse. The parser shall not invoke this method until it has either abandoned parsing (because of an unrecoverable error) or reached the end of input.

Parameters: source the input source

Throws: CSSException Any CSS exception, possibly wrapping another exception.

endFontFace

public void endFontFace()
Receive notification of the end of a font face statement.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

endMedia

public void endMedia(SACMediaList media)
Receive notification of the end of a media statement.

Parameters: media The intended destination media for style information.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

endPage

public void endPage(String name, String pseudo_page)
Receive notification of the end of a media statement.

Parameters: name The intended destination medium for style information. pseudo_page the pseudo page (if any, null otherwise)

Throws: CSSException Any CSS exception, possibly wrapping another exception.

endSelector

public void endSelector(SelectorList selectors)
Receive notification of the end of a rule statement.

Parameters: selectors All intended selectors for all declarations.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

error

public void error(CSSParseException exception)
Receive notification of a recoverable error.

This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.

The CSS parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.

Parameters: exception The error information encapsulated in a CSS parse exception.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

See Also: CSSParseException

fatalError

public void fatalError(CSSParseException exception)
Receive notification of a non-recoverable error.

This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.

The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting addition error messages: in fact, CSS parsers are free to stop reporting any other events once this method has been invoked.

Parameters: exception The error information encapsulated in a CSS parse exception.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

See Also: CSSParseException

getDefaultNamespaceURI

public String getDefaultNamespaceURI()

getDependencies

public DependencyCollector getDependencies()

getParentRule

protected StyleRule getParentRule()

getResourceManager

public ResourceManager getResourceManager()

getSource

public ResourceKey getSource()

getStyleRule

public CSSDeclarationRule getStyleRule()

getStyleSheet

public StyleSheet getStyleSheet()

ignorableAtRule

public void ignorableAtRule(String atRule)
Receive notification of an unknown rule t-rule not supported by this parser.

Parameters: atRule The complete ignored at-rule.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

importStyle

public void importStyle(String uri, SACMediaList media, String defaultNamespaceURI)
Receive notification of a import statement in the style sheet.

Parameters: uri The URI of the imported style sheet. media The intended destination media for style information. defaultNamespaceURI The default namespace URI for the imported style sheet.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

init

public void init(ResourceManager manager, ResourceKey source, long version, StyleKeyRegistry registry, StyleRule parentRule)

initParseContext

public void initParseContext(InputSource source)

namespaceDeclaration

public void namespaceDeclaration(String prefix, String uri)
Receive notification of an unknown rule t-rule not supported by this parser.

Parameters: prefix null if this is the default namespace uri The URI for this namespace.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

property

public void property(String name, LexicalUnit value, boolean important)
Receive notification of a declaration.

Parameters: name the name of the property. value the value of the property. All whitespace are stripped. important is this property important ?

Throws: CSSException Any CSS exception, possibly wrapping another exception.

registerNamespace

public void registerNamespace(String prefix, String uri)

setDefaultNamespaceURI

public void setDefaultNamespaceURI(String defaultNamespace)

setStyleRule

public void setStyleRule(CSSDeclarationRule styleRule)

setStyleSheet

public void setStyleSheet(StyleSheet styleSheet)

startDocument

public void startDocument(InputSource source)
Receive notification of the beginning of a style sheet.

The CSS parser will invoke this method only once, before any other methods in this interface.

Parameters: source the input source

Throws: CSSException Any CSS exception, possibly wrapping another exception.

startFontFace

public void startFontFace()
Receive notification of the beginning of a font face statement.

The Parser will invoke this method at the beginning of every font face statement in the style sheet. there will be a corresponding endFontFace() event for every startFontFace() event.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

startMedia

public void startMedia(SACMediaList media)
Receive notification of the beginning of a media statement.

The Parser will invoke this method at the beginning of every media statement in the style sheet. there will be a corresponding endMedia() event for every startElement() event.

Parameters: media The intended destination media for style information.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

startPage

public void startPage(String name, String pseudo_page)
Receive notification of the beginning of a page statement.

The Parser will invoke this method at the beginning of every page statement in the style sheet. there will be a corresponding endPage() event for every startPage() event.

Parameters: name the name of the page (if any, null otherwise) pseudo_page the pseudo page (if any, null otherwise)

Throws: CSSException Any CSS exception, possibly wrapping another exception.

startSelector

public void startSelector(SelectorList selectors)
Receive notification of the beginning of a rule statement.

Parameters: selectors All intended selectors for all declarations.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

warning

public void warning(CSSParseException exception)
Receive notification of a warning.

CSS parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML 1.0 recommendation. The default behaviour is to take no action.

The CSS parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end.

Parameters: exception The warning information encapsulated in a CSS parse exception.

Throws: CSSException Any CSS exception, possibly wrapping another exception.

See Also: CSSParseException