com.steadystate.css.parser
Class HandlerBase

java.lang.Object
  extended by 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