P6R::p6ISAX2ContentHandler Interface Reference

This SAX2 interface is implemented by an application using P6R's XML parser. More...

#include <p6sax2contenthandler.h>

Inherits P6R::p6ICom.

List of all members.

Public Member Functions

virtual P6R::P6INT32 addref ()=0
 This method increases the reference count of the component instance by one.
virtual P6R::P6ERR characters (P6SAX2STRING *pBuffer, P6SAX2METADATA meta)=0
 Provides an element's contents to the application.
virtual P6R::P6ERR endDocument ()=0
 Provides an application the notification when the end of the XML input document has been reached by the parser.
virtual P6R::P6ERR endElement (P6SAX2STRING *pURI, P6SAX2STRING *pLocalName, P6SAX2STRING *pQName)=0
 Provides an application the notification when the most recent element (as defined by a callback of the startElement method below) has ended.
virtual P6R::P6ERR endPrefixMapping (P6SAX2STRING *pPrefix)=0
 Provides an application the notification when a namespace has just gone out of scope.
virtual P6R::P6ERR ignorableWhitespace (const P6CHAR *pBuffer, P6UINT32 start, P6UINT32 length)=0
 p6ISAX2XMLReader is a non-validating parser and does not implement this callback.
virtual P6R::P6ERR processingInstruction (P6SAX2STRING *pTarget, P6SAX2STRING *pData)=0
 Provides an applicaiton with the notification that an XML processing instruction has been detected.
virtual P6R::P6ERR queryInterface (const P6R::IID &iid, P6R::P6VOID **ppIface)=0
 This method queries the component for a specific interface.
virtual P6R::P6INT32 release ()=0
 This method decrements a components reference count.
virtual P6R::P6ERR setDocumentLocator (p6ISAX2Locator *pObject)=0
 This method is called just before the startDocument() method and the application is given a p6ISAX2Locator component created by the XML parser.
virtual P6R::P6ERR skippedEntity (P6SAX2STRING *pName)=0
 Non-validating parsers may skip entities whose definition,s are defined in DTDs that has not been read.
virtual P6R::P6ERR startDocument ()=0
 Provides an application the notification when the start of the XML input document has been reached by the parser.
virtual P6R::P6ERR startElement (P6SAX2STRING *pURI, P6SAX2STRING *pLocalName, P6SAX2STRING *pQName, P6SAX2STRING *pRawElement, p6ISAX2Attributes *pAtts)=0
 Provides an application the notification when a new element has been detected.
virtual P6R::P6ERR startPrefixMapping (P6SAX2STRING *pPrefix, P6SAX2STRING *pURI)=0
 Provides an application the notification when a new namespace is just about to come into scope.

Detailed Description

This SAX2 interface is implemented by an application using P6R's XML parser.

This is a callback object that is registered with the p6ISAX2XMLReader::setContentHandler() method. This is the main parsing interface to the application. It provides a stream of events for each item in the input XML document. Each event results in a method call to one of the methods below.

 For example, a typical set of events could be:
 startDocument()    -  &lt;?xml version='1.0' ?&gt;
 startElement()     -  &lt;container&gt;
 startElement()     -     &lt;name>&gt;
 characters()       -       some value 
 characters()       -       some value
 endElement()       -     &lt;/name&gt;
 endDocument        -  &lt;/container&gt;
 
 Note that the following standard callback methods are not currently called by the P6R's XML parser:
 ignorableWhitespace();
 processingInstruction();
 skippedEntity();

Definition at line 60 of file p6sax2contenthandler.h.


The documentation for this interface was generated from the following file:
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines
Copyright © 2004 - 2010 P6R Inc. - All Rights Reserved.