This abstract class provides the interface for the scanner to return XML document information up to the parser as it scans through the document
This abstract class provides the interface for the scanner to return XML document information up to the parser as it scans through the document. The interface is very similar to org.sax.DocumentHandler, but has some extra methods.Some of the methods are designated as 'advanced' callbacks. They are enabled only if the 'setAdvancedCallbacks' flag has been set on the default scanner implementation.
The scanner will call this method to report each chunk of character data. The scanner may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event will come from the same external entity, so that the Locator provides useful information.
The parser must not attempt to read from the array outside of the specified range.
Validating Parsers must use this method to report each chunk
of ignorable whitespace (see the W3C XML 1.0 recommendation,
section 2.10): non-validating parsers may also use this method
if they are capable of parsing and using content models. The scanner may return all contiguous whitespace in a single
chunk, or it may split it into several chunks; however, all of
the characters in any single event will come from the same
external entity, so that the Locator provides useful
information. The parser must not attempt to read from the array
outside of the specified range.
virtual void docComment( const XMLCh* const comment, const unsigned int fStartSrcOfs, const unsigned int fEndSrcOfs )
virtual void docPI( const XMLCh* const target, const XMLCh* const data, const unsigned int fStartSrcOfs, const unsigned int fEndSrcOfs )
data - The body of the PI. virtual void endDocument()
virtual void endElement( const XMLCh* const elementName, const bool isRoot, const unsigned int fStartSrcOfs, const unsigned int fEndSrcOfs )
isRoot - Indicates if this is the root element. virtual void endEntityReference(const XMLCh* const entityName)
virtual void ignorableWhitespace( const XMLCh* const chars, const unsigned int length, const bool cdataSection )
length - The number of characters to read from the array.
cdataSection - Indicates that this data is inside a CDATA
section.
virtual void resetDocument()
virtual void startDocument()
virtual void startElement( const XMLCh* const elementName, const RefVectorOf
attrList - The list of attributes. Its returned as a list
of references to attribute objects.
attrCount - The number of attributes in the
attrList
.
isEmpty - Indicates whether its an element or not. Empty
elements are of the form
.
isRoot - Indicates whether this element is the root
element or not. If true, then there will be no
separate endElement() event. virtual void startEntityReference(const XMLCh* const entityName)
virtual void XMLDecl( const XMLCh* const versionStr, const XMLCh* const encodingStr, const XMLCh* const standaloneStr, const XMLCh* const autoEncodingStr, const unsigned int fStartSrcOfs, const unsigned int fEndSrcOfs )
version
attribute
of the XML decl.
encodingStr - The value of the encoding
attribute
of the XML decl.
standaloneStr - The value of the standalone
attribute of the XML decl.
autoEncodingStr - The encoding string auto-detected by the
scanner. In absence of any 'encoding' attribute in the
XML decl, the XML standard specifies how a parser can
auto-detect. If there is no encodingStr
this is what will be used to try to decode the file.
void operator=(const XMLDocumentHandler&)
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 |
|