class HandlerBase : public EntityResolver, public DTDHandler, public DocumentHandler, public ErrorHandler class HandlerBase : public EntityResolver, public DTDHandler, public DocumentHandler, public ErrorHandler 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
|
private :
EntityResolver(const EntityResolver&)
void operator=(const EntityResolver&)
Constructors and Destructor
EntityResolver()
virtual ~EntityResolver()
The EntityResolver interface
virtual InputSource* resolveEntity( const XMLCh* const publicId, const XMLCh* const systemId )
The DTD handler interface
virtual void notationDecl( const XMLCh* const name, const XMLCh* const publicId, const XMLCh* const systemId )
virtual void unparsedEntityDecl( const XMLCh* const name, const XMLCh* const publicId, const XMLCh* const systemId, const XMLCh* const notationName )
private Unimplemented constructors and operators
DTDHandler(const DTDHandler&)
void operator=(const DTDHandler&)
The virtual document handler interface
virtual void characters( const XMLCh* const chars, const unsigned int length )
virtual void endDocument()
virtual void endElement(const XMLCh* const name)
virtual void ignorableWhitespace( const XMLCh* const chars, const unsigned int length )
virtual void processingInstruction( const XMLCh* const target, const XMLCh* const data )
virtual void setDocumentLocator(Locator* const locator)
virtual void startDocument()
virtual void startElement( const XMLCh* const name, AttributeList& attrs )
private Unimplemented Constructors and operators
DocumentHandler(const DocumentHandler&)
void operator=(const DocumentHandler&)
The error handler interface
virtual void warning(const SAXParseException& exception)
virtual void error(const SAXParseException& exception)
virtual void fatalError(const SAXParseException& exception)
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.
$Log: HandlerBase.hpp,v $ Revision 1.1.1.1 1999/11/09 01:07:45 twl Initial checkin Revision 1.2 1999/11/08 20:45:00 rahul Swat for adding in Product name and CVS comment log variable.
Default handlers for the DocumentHandler interface
virtual void characters( const XMLCh* const chars, const unsigned int length )
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.
Default implementation of DocumentHandler interface
virtual void setDocumentLocator(Locator* const locator)
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.
Default implementation of the EntityResolver interface.
virtual InputSource* resolveEntity( const XMLCh* const publicId, const XMLCh* const systemId )
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.
Default implementation of the ErrorHandler interface
virtual void error(const SAXParseException& exception)
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
Default implementation of DTDHandler interface.
virtual void notationDecl( const XMLCh* const name, const XMLCh* const publicId, const XMLCh* const systemId )
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 |
|
