classIBXMLCALL DriverText: public Parser

Driver for a MIME type text/xml parser

Inheritance:

DriverText - Parser


Public

[more] Constructors and destructor.
[more] The text/xml driver interface.


Inherited from Parser:

Public

Parser interface.


Documentation

Driver for a MIME type text/xml parser.

The driver uses the expat XML parser to parse XML data and translates the events reported by expat to the registered client handlers.

o Constructors and destructor.

o DriverText()
Default constructor.

o ~DriverText()
Destructor.

o The text/xml driver interface.

ovoid setEntityResolver(EntityResolver* resolver)
Set a custom EntityResolver for the Parser.

If no EntityResolver is specified, the parser shall resolve entities itself. The EntityResolver may be specified at any time, also in the middle of a parse, and the parser shall start using the new handler immediately.

Parameters:
handler - A pointer to a EntityResolver object to be used by the parser, or null if none is specified.
See Also:
setEntityResolver
EntityResolver

ovoid setDTDHandler(DTDHandler* handler)
Set a custom DTDHandler for the Parser.

If no DTDHandler is specified, no DTD related events are generated. The DTDHandler may be specified at any time, also in the middle of a parse, and the parser shall start using the new handler immediately.

Parameters:
handler - A pointer to a DTDHandler object to be used by the parser, or null if none is specified.
See Also:
setDTDHandler
DTDHandler

ovoid setDocumentHandler(DocumentHandler* handler)
Set a custom DocumentHandler for the Parser.

If no DocumentHandler is specified, no document events are generated. The DocumentHandler may be specified at any time, also in the middle of a parse, and the parser shall start using the new handler immediately.

Parameters:
handler - A pointer to a DocumentHandler object to be used by the parser, or null if none is specified.
See Also:
setDocumentHandler
setDocumentHandler

ovoid setErrorHandler(ErrorHandler* handler)
Set a custom ErrorHandler for the Parser.

If no ErrorHandler is specified, no errors or warnings are generated, except fatal errors. Fatal errors will result in a SAXException being thrown. The ErrorHandler may be specified at any time, also in the middle of a parse, and the parser shall start using the new handler immediately.

Parameters:
handler - A pointer to a ErrorHandler object to be used by the parser, or null if none is specified.
See Also:
setErrorHandler
setErrorHandler

ovoid parse(InputSource& source)
Start parsing of the XML document specified by an input source.

The parser will begin parsing the XML document specified by the input source and call the appropriate DocumentHandler, DTDHandler, ErrorHandler and EntityResolver methods in the same order as the events occur in the XML document.

The application may not call this method recusively or multiple times on the same instance.

Throws:
SAXException A SAXException is thrown to indicate that an error occured while parsing, and that it was not handled by any ErrorHandler. A SAXException is also thrown if an IO error occurs in the underlying URI connection.
Parameters:
source - A reference to an InputSource object to be used by the parser.
See Also:
parse

ovoid parse(const ibxmlchar* systemId)
Start parsing of the XML document specified by a system identifier.

The parser will begin parsing the XML document specified by the input source and call the appropriate DocumentHandler, DTDHandler, ErrorHandler and EntityResolver methods in the same order as the events occur in the XML document.

The application may not call this method recusively or multiple times on the same instance.

Throws:
SAXException An SAXException is thrown to indicate that an error occured while parsing, and that it was not handled by any ErrorHandler. A SAXException is also thrown if an IO error occurs in the underlying URI connection.
Parameters:
systemId - A pointer to a string containing the name of the system identifier to be used by the parser.
See Also:
parse

ovoid parse(const char* systemId)
Start parsing of the XML document specified by a system identifier.

The parser will begin parsing the XML document specified by the input source and call the appropriate DocumentHandler, DTDHandler, ErrorHandler and EntityResolver methods in the same order as the events occur in the XML document.

The application may not call this method recusively or multiple times on the same instance.

Throws:
SAXException An SAXException is thrown to indicate that an error occured while parsing, and that it was not handled by any ErrorHandler. A SAXException is also thrown if an IO error occurs in the underlying URI connection.
Parameters:
systemId - A pointer to a string containing the name of the system identifier to be used by the parser.
See Also:
parse


This class has no child classes.
See Also:
Parser

Alphabetic index Hierarchy of classes



This page was generated with the help of DOC++.