DOMImplementationLS contains the factory methods for
* creating objects that implement the DOMBuilder (parser) and
* DOMWriter (serializer) interfaces.
An object that implements DOMImplementationLS is obtained by doing a * binding specific cast from DOMImplementation to DOMImplementationLS. * Implementations supporting the Load and Save feature must implement the * DOMImplementationLS interface on whatever object implements the * DOMImplementation interface.
* * @since DOM Level 3 */ class CDOM_EXPORT DOMImplementationLS { protected: // ----------------------------------------------------------------------- // Hidden constructors // ----------------------------------------------------------------------- /** @name Hidden constructors */ //@{ DOMImplementationLS() {}; //@} private: // ----------------------------------------------------------------------- // Unimplemented constructors and operators // ----------------------------------------------------------------------- /** @name Unimplemented constructors and operators */ //@{ DOMImplementationLS(const DOMImplementationLS &); DOMImplementationLS & operator = (const DOMImplementationLS &); //@} public: // ----------------------------------------------------------------------- // All constructors are hidden, just the destructor is available // ----------------------------------------------------------------------- /** @name Destructor */ //@{ /** * Destructor * */ virtual ~DOMImplementationLS() {}; //@} // ----------------------------------------------------------------------- // Public constants // ----------------------------------------------------------------------- /** @name Public constants */ //@{ /** * Create a synchronous or an asynchronousDOMBuilder.
* @see createDOMBuilder(const short mode, const XMLCh* const schemaType)
* @since DOM Level 3
*
*/
enum
{
MODE_SYNCHRONOUS = 1,
MODE_ASYNCHRONOUS = 2
};
//@}
// -----------------------------------------------------------------------
// Virtual DOMImplementation LS interface
// -----------------------------------------------------------------------
/** @name Functions introduced in DOM Level 3 */
//@{
// -----------------------------------------------------------------------
// Factory create methods
// -----------------------------------------------------------------------
/**
* Create a new DOMBuilder. The newly constructed parser may then be
* configured by means of its setFeature method, and used to parse
* documents by means of its parse method.
*
* "Experimental - subject to change"
* * @param mode The mode argument is eitherMODE_SYNCHRONOUS or
* MODE_ASYNCHRONOUS, if mode is MODE_SYNCHRONOUS
* then the DOMBuilder that is created will operate in
* synchronous mode, if it's MODE_ASYNCHRONOUS then the
* DOMBuilder that is created will operate in asynchronous
* mode.
* @param schemaType An absolute URI representing the type of the schema
* language used during the load of a DOMDocument using the newly created
* DOMBuilder. Note that no lexical checking is done on the
* absolute URI. In order to create a DOMBuilder for any kind of schema
* types (i.e. the DOMBuilder will be free to use any schema found), use
* the value null.
* @param manager Pointer to the memory manager to be used to
* allocate objects.
* @param gramPool The collection of cached grammers.
* @return The newly created DOMBuilder object. This
* DOMBuilder is either synchronous or asynchronous depending
* on the value of the mode argument.
* @exception DOMException NOT_SUPPORTED_ERR: Raised if the requested mode
* or schema type is not supported.
*
* @see DOMBuilder
* @since DOM Level 3
*/
virtual DOMBuilder* createDOMBuilder(const short mode,
const XMLCh* const schemaType,
MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager,
XMLGrammarPool* const gramPool = 0) = 0;
/**
* Create a new DOMWriter. DOMWriters are used to serialize a DOM tree
* back into an XML document.
*
* "Experimental - subject to change"
*
* @return The newly created DOMWriter object.
*
* @see DOMWriter
* @since DOM Level 3
*/
virtual DOMWriter* createDOMWriter(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager) = 0;
/**
* Create a new "empty" DOMInputSource.
*
* "Experimental - subject to change"
*
* @return The newly created DOMInputSource object.
* @exception DOMException NOT_SUPPORTED_ERR: Raised if this function is not
* supported by implementation
*
* @see DOMInputSource
* @since DOM Level 3
*/
virtual DOMInputSource* createDOMInputSource() = 0;
//@}
};
XERCES_CPP_NAMESPACE_END
#endif