com.steadystate.css.parser
Class HandlerBase

java.lang.Object
  com.steadystate.css.parser.HandlerBase

All Implemented Interfaces:

DocumentHandler, ErrorHandler

Direct Known Subclasses:

ParseTest

public class HandlerBase
extends java.lang.Object
implements DocumentHandler, ErrorHandler

Constructor Summary

HandlerBase()

Method Summary

void	comment(java.lang.String text) Receive notification of a comment.
void	endDocument(InputSource source) Receive notification of the end of a document.
void	endFontFace() Receive notification of the end of a font face statement.
void	endMedia(SACMediaList media) Receive notification of the end of a media statement.
void	endPage(java.lang.String name, java.lang.String pseudo_page) Receive notification of the end of a media statement.
void	endSelector(SelectorList selectors) Receive notification of the end of a rule statement.
void	error(CSSParseException exception) Receive notification of a recoverable error.
void	fatalError(CSSParseException exception) Receive notification of a non-recoverable error.
void	ignorableAtRule(java.lang.String atRule) Receive notification of an unknown rule t-rule not supported by this parser.
void	importStyle(java.lang.String uri, SACMediaList media, java.lang.String defaultNamespaceURI) Receive notification of a import statement in the style sheet.
void	namespaceDeclaration(java.lang.String prefix, java.lang.String uri) Receive notification of an unknown rule t-rule not supported by this parser.
void	property(java.lang.String name, LexicalUnit value, boolean important) Receive notification of a declaration.
void	startDocument(InputSource source) Receive notification of the beginning of a style sheet.
void	startFontFace() Receive notification of the beginning of a font face statement.
void	startMedia(SACMediaList media) Receive notification of the beginning of a media statement.
void	startPage(java.lang.String name, java.lang.String pseudo_page) Receive notification of the beginning of a page statement.
void	startSelector(SelectorList selectors) Receive notification of the beginning of a rule statement.
void	warning(CSSParseException exception) Receive notification of a warning.

Methods inherited from class java.lang.Object

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

Constructor Detail

HandlerBase

public HandlerBase()

Method Detail

startDocument

public void startDocument(InputSource source)
                   throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

startDocument in interface DocumentHandler

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

endDocument

public void endDocument(InputSource source)
                 throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

endDocument in interface DocumentHandler

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

comment

public void comment(java.lang.String text)
             throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

comment in interface DocumentHandler

Parameters:

text - The comment.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

ignorableAtRule

public void ignorableAtRule(java.lang.String atRule)
                     throws CSSException

Description copied from interface: DocumentHandler

Receive notification of an unknown rule t-rule not supported by this parser.

Specified by:

ignorableAtRule in interface DocumentHandler

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

namespaceDeclaration

public void namespaceDeclaration(java.lang.String prefix,
                                 java.lang.String uri)
                          throws CSSException

Description copied from interface: DocumentHandler

Receive notification of an unknown rule t-rule not supported by this parser.

Specified by:

namespaceDeclaration in interface DocumentHandler

Parameters:

prefix - null if this is the default namespace

uri - The URI for this namespace.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

importStyle

public void importStyle(java.lang.String uri,
                        SACMediaList media,
                        java.lang.String defaultNamespaceURI)
                 throws CSSException

Description copied from interface: DocumentHandler

Receive notification of a import statement in the style sheet.

Specified by:

importStyle in interface DocumentHandler

Parameters:

uri - The URI of the imported style sheet.

media - The intended destination media for style information.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

startMedia

public void startMedia(SACMediaList media)
                throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

startMedia in interface DocumentHandler

Parameters:

media - The intended destination media for style information.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

endMedia

public void endMedia(SACMediaList media)
              throws CSSException

Description copied from interface: DocumentHandler

Receive notification of the end of a media statement.

Specified by:

endMedia in interface DocumentHandler

Parameters:

media - The intended destination media for style information.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

startPage

public void startPage(java.lang.String name,
                      java.lang.String pseudo_page)
               throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

startPage in interface DocumentHandler

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.

endPage

public void endPage(java.lang.String name,
                    java.lang.String pseudo_page)
             throws CSSException

Description copied from interface: DocumentHandler

Receive notification of the end of a media statement.

Specified by:

endPage in interface DocumentHandler

pseudo_page - the pseudo page (if any, null otherwise)

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

startFontFace

public void startFontFace()
                   throws CSSException

Description copied from interface: DocumentHandler

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.

Specified by:

startFontFace in interface DocumentHandler

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

endFontFace

public void endFontFace()
                 throws CSSException

Description copied from interface: DocumentHandler

Receive notification of the end of a font face statement.

Specified by:

endFontFace in interface DocumentHandler

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

startSelector

public void startSelector(SelectorList selectors)
                   throws CSSException

Description copied from interface: DocumentHandler

Receive notification of the beginning of a rule statement.

Specified by:

startSelector in interface DocumentHandler

Parameters:

selectors - All intended selectors for all declarations.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

endSelector

public void endSelector(SelectorList selectors)
                 throws CSSException

Description copied from interface: DocumentHandler

Receive notification of the end of a rule statement.

Specified by:

endSelector in interface DocumentHandler

Parameters:

selectors - All intended selectors for all declarations.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

property

public void property(java.lang.String name,
                     LexicalUnit value,
                     boolean important)
              throws CSSException

Description copied from interface: DocumentHandler

Receive notification of a declaration.

Specified by:

property in interface DocumentHandler

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.

warning

public void warning(CSSParseException exception)
             throws CSSException

Description copied from interface: ErrorHandler

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.

Specified by:

warning in interface ErrorHandler

Parameters:

exception - The warning information encapsulated in a CSS parse exception.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

See Also:

CSSParseException

error

public void error(CSSParseException exception)
           throws CSSException

Description copied from interface: ErrorHandler

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.

Specified by:

error in interface ErrorHandler

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)
                throws CSSException

Description copied from interface: ErrorHandler

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.

Specified by:

fatalError in interface ErrorHandler

Parameters:

exception - The error information encapsulated in a CSS parse exception.

Throws:

CSSException - Any CSS exception, possibly wrapping another exception.

See Also:

CSSParseException