If a SAX application needs information about notations and * unparsed entities, then the application implements this * interface and registers an instance with the SAX parser using * the parser's setDTDHandler method. The parser uses the * instance to report notation and unparsed entity declarations to * the application.
* *The SAX parser may report these events in any order, regardless * of the order in which the notations and unparsed entities were * declared; however, all DTD events must be reported after the * document handler's startDocument event, and before the first * startElement event.
* *It is up to the application to store the information for * future use (perhaps in a hash table or object tree). * If the application encounters attributes of type "NOTATION", * "ENTITY", or "ENTITIES", it can use the information that it * obtained through this interface to find the entity and/or * notation corresponding with the attribute value.
* *The HandlerBase class provides a default implementation * of this interface, which simply ignores the events.
* * @see Parser#setDTDHandler * @see HandlerBase#HandlerBase */ class SAX_EXPORT DTDHandler { public: /** @name Constructors and Destructor */ //@{ /** Default Constructor */ DTDHandler() { } /** Destructor */ virtual ~DTDHandler() { } //@} /** @name The DTD handler interface */ //@{ /** * Receive notification of a notation declaration event. * *It is up to the application to record the notation for later * reference, if necessary.
* *If a system identifier is present, and it is a URL, the SAX * parser must resolve it fully before passing it to the * application.
* * @param name The notation name. * @param publicId The notation's public identifier, or null if * none was given. * @param systemId The notation's system identifier, or null if * none was given. * @exception SAXException Any SAX exception, possibly * wrapping another exception. * @see #unparsedEntityDecl * @see AttributeList#AttributeList */ virtual void notationDecl ( const XMLCh* const name , const XMLCh* const publicId , const XMLCh* const systemId ) = 0; /** * Receive notification of an unparsed entity declaration event. * *Note that the notation name corresponds to a notation * reported by the notationDecl() event. It is up to the * application to record the entity for later reference, if * necessary.
* *If the system identifier is a URL, the parser must resolve it * fully before passing it to the application.
* * @exception SAXException Any SAX exception, possibly * wrapping another exception. * @param name The unparsed entity's name. * @param publicId The entity's public identifier, or null if none * was given. * @param systemId The entity's system identifier (it must always * have one). * @param notationName The name of the associated notation. * @see #notationDecl * @see AttributeList#AttributeList */ virtual void unparsedEntityDecl ( const XMLCh* const name , const XMLCh* const publicId , const XMLCh* const systemId , const XMLCh* const notationName ) = 0; /** * Reset the DocType object on its reuse * *This method helps in reseting the DTD object implementational * defaults each time the DTD is begun.
* */ virtual void resetDocType() = 0; //@} private : /* Unimplemented constructors and operators */ /* Copy constructor */ DTDHandler(const DTDHandler&); /* Assignment operator */ void operator=(const DTDHandler&); }; XERCES_CPP_NAMESPACE_END #endif