Applications needing to implement customized handling for external * entities must implement this interface and register their implementation * by setting the entityResolver attribute of the DOMBuilder.
* *The DOMBuilder will then allow the application to intercept any * external entities (including the external DTD subset and external parameter * entities) before including them.
* *Many DOM applications will not need to implement this interface, but it * will be especially useful for applications that build XML documents from * databases or other specialized input sources, or for applications that use * URNs.
* * @see DOMBuilder#setEntityResolver * @see DOMInputSource#DOMInputSource * @since DOM Level 3 */ class CDOM_EXPORT DOMEntityResolver { protected: // ----------------------------------------------------------------------- // Hidden constructors // ----------------------------------------------------------------------- /** @name Hidden constructors */ //@{ DOMEntityResolver() {}; DOMEntityResolver(const DOMEntityResolver &) {}; DOMEntityResolver & operator = (const DOMEntityResolver &) {return *this;}; //@} public: // ----------------------------------------------------------------------- // All constructors are hidden, just the destructor is available // ----------------------------------------------------------------------- /** @name Destructor */ //@{ /** * Destructor * */ virtual ~DOMEntityResolver() {}; //@} // ----------------------------------------------------------------------- // Virtual DOMEntityResolver interface // ----------------------------------------------------------------------- /** @name Functions introduced in DOM Level 2 */ //@{ /** * Allow the application to resolve external entities. * *The DOMBuilder will call this method before opening any external * entity except the top-level document entity (including the * external DTD subset, external entities referenced within the * DTD, and external entities referenced within the document * element): the application may request that the DOMBuilder resolve * the entity itself, that it use an alternative URI, or that it * use an entirely different input source.
* *Application writers can use this method to redirect external * system identifiers to secure and/or local URIs, to look up * public identifiers in a catalogue, or to read an entity from a * database or other input source (including, for example, a dialog * box).
* *If the system identifier is a URL, the DOMBuilder parser must * resolve it fully before reporting it to the application.
* *The returned DOMInputSource is owned by the DOMBuilder which is * responsible to clean up the memory. * *
"Experimental - subject to change"
* * @param publicId The public identifier of the external entity * being referenced, or null if none was supplied. * @param systemId The system identifier of the external entity * being referenced. * @param baseURI The absolute base URI of the resource being parsed, or *null if there is no base URI.
* @return A DOMInputSource object describing the new input source,
* or null to request that the parser open a regular
* URI connection to the system identifier.
* The returned DOMInputSource is owned by the DOMBuilder which is
* responsible to clean up the memory.
* @exception DOMSystemException Any DOMSystemException exception, possibly
* wrapping another exception.
* @see DOMInputSource#DOMInputSource
* @since DOM Level 3
*/
virtual DOMInputSource* resolveEntity
(
const XMLCh* const publicId
, const XMLCh* const systemId
, const XMLCh* const baseURI
) = 0;
//@}
};
XERCES_CPP_NAMESPACE_END
#endif