Default base class for handlers
![]() | Default handlers for the DocumentHandler interface | ||||||
![]() | Default implementation of DocumentHandler interface
| ||||||
![]() | Default implementation of DTDHandler interface. | ||||||
![]() | Default implementation of the EntityResolver interface.
| ||||||
![]() | Default implementation of the ErrorHandler interface
|
Constructors and Destructor
The EntityResolver interface
The DTD handler interface
private Unimplemented constructors and operators
The virtual document handler interface
private Unimplemented Constructors and operators
The error handler interface
Default base class for handlers.This class implements the default behaviour for four SAX interfaces: EntityResolver, DTDHandler, DocumentHandler, and ErrorHandler.
Application writers can extend this class when they need to implement only part of an interface; parser writers can instantiate this class to provide default handlers when the application has not supplied its own.
Note that the use of this class is optional.
By default, do nothing. Application writers may override this method to take specific actions for each chunk of character data (such as adding the data to a node or buffer, or printing it to a file).
By default, do nothing. Application writers may override this
method in a subclass to take specific actions at the beginning
of a document (such as finalising a tree or closing an output
file).
By default, do nothing. Application writers may override this
method in a subclass to take specific actions at the end of
each element (such as finalising a tree node or writing
output to a file).
By default, do nothing. Application writers may override this
method to take specific actions for each chunk of ignorable
whitespace (such as adding data to a node or buffer, or printing
it to a file).
By default, do nothing. Application writers may override this
method in a subclass to take specific actions for each
processing instruction, such as setting status variables or
invoking other methods. virtual void endDocument()
virtual void endElement(const XMLCh* const name)
virtual void ignorableWhitespace( const XMLCh* const chars, const unsigned int length )
length - The number of characters to use from the
character array.
virtual void processingInstruction( const XMLCh* const target, const XMLCh* const data )
data - The processing instruction data, or null if
none is supplied.
By default, do nothing. Application writers may override this method in a subclass if they wish to store the locator for use with other document events.
By default, do nothing. Application writers may override this
method in a subclass to take specific actions at the beginning
of a document (such as allocating the root node of a tree or
creating an output file).
By default, do nothing. Application writers may override this
method in a subclass to take specific actions at the start of
each element (such as allocating a new tree node or writing
output to a file). virtual void startDocument()
virtual void startElement( const XMLCh* const name, AttributeList& attributes )
attributes - The specified or defaulted attributes.
Always return null, so that the parser will use the system identifier provided in the XML document. This method implements the SAX default behaviour: application writers can override it in a subclass to do special translations such as catalog lookups or URI redirection.
The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each error, such as inserting the message in a log file or printing it to the console.
The default implementation throws a SAXParseException.
Application writers may override this method in a subclass if
they need to take specific actions for each fatal error (such as
collecting all of the errors into a single report): in any case,
the application must stop all regular processing when this
method is invoked, since the document is no longer reliable, and
the parser may no longer report parsing events.
The default implementation does nothing. Application writers
may override this method in a subclass to take specific actions
for each warning, such as inserting the message in a log file or
printing it to the console. virtual void fatalError(const SAXParseException& exception)
SAXParseException virtual void warning(const SAXParseException& exception)
SAXParseException
By default, do nothing. Application writers may override this method in a subclass if they wish to keep track of the notations declared in a document.
By default, do nothing. Application writers may override this
method in a subclass to keep track of the unparsed entities
declared in a document. virtual void unparsedEntityDecl( const XMLCh* const name, const XMLCh* const publicId, const XMLCh* const systemId, const XMLCh* const notationName )
publicId - The entity public identifier, or null if not
available.
systemId - The entity system identifier.
notationName - The name of the associated notation.
alphabetic index hierarchy of classes
XML Parser for C++ 2.0 Copyright © IBM Corp, 1999 Center for Java Technology 10275 N. De Anza Blvd. Cupertino CA 95014 USA Email: xml4c@us.ibm.com |
|