// // DOMBuilder.h // // $Id: //poco/1.4/XML/include/Poco/DOM/DOMBuilder.h#1 $ // // Library: XML // Package: DOM // Module: DOMBuilder // // Definition of the DOMBuilder class. // // Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH. // and Contributors. // // Permission is hereby granted, free of charge, to any person or organization // obtaining a copy of the software and accompanying documentation covered by // this license (the "Software") to use, reproduce, display, distribute, // execute, and transmit the Software, and to prepare derivative works of the // Software, and to permit third-parties to whom the Software is furnished to // do so, all subject to the following: // // The copyright notices in the Software and this entire statement, including // the above license grant, this restriction and the following disclaimer, // must be included in all copies of the Software, in whole or in part, and // all derivative works of the Software, unless such copies or derivative // works are solely in the form of machine-executable object code generated by // a source language processor. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT // SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE // FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. // #ifndef DOM_DOMBuilder_INCLUDED #define DOM_DOMBuilder_INCLUDED #include "Poco/XML/XML.h" #include "Poco/SAX/ContentHandler.h" #include "Poco/SAX/LexicalHandler.h" #include "Poco/SAX/DTDHandler.h" #include "Poco/XML/XMLString.h" namespace Poco { namespace XML { class XMLReader; class Document; class InputSource; class AbstractNode; class AbstractContainerNode; class NamePool; class XML_API DOMBuilder: protected DTDHandler, protected ContentHandler, protected LexicalHandler /// This class builds a tree representation of an /// XML document, according to the W3C Document Object Model, Level 1 and 2 /// specifications. /// /// The actual XML parsing is done by an XMLReader, which /// must be supplied to the DOMBuilder. { public: DOMBuilder(XMLReader& xmlReader, NamePool* pNamePool = 0); /// Creates a DOMBuilder using the given XMLReader. /// If a NamePool is given, it becomes the Document's NamePool. virtual ~DOMBuilder(); /// Destroys the DOMBuilder. virtual Document* parse(const XMLString& uri); /// Parse an XML document from a location identified by an URI. virtual Document* parse(InputSource* pInputSource); /// Parse an XML document from a location identified by an InputSource. virtual Document* parseMemoryNP(const char* xml, std::size_t size); /// Parses an XML document from memory. protected: // DTDHandler void notationDecl(const XMLString& name, const XMLString* publicId, const XMLString* systemId); void unparsedEntityDecl(const XMLString& name, const XMLString* publicId, const XMLString& systemId, const XMLString& notationName); // ContentHandler void setDocumentLocator(const Locator* loc); void startDocument(); void endDocument(); void startElement(const XMLString& uri, const XMLString& localName, const XMLString& qname, const Attributes& attributes); void endElement(const XMLString& uri, const XMLString& localName, const XMLString& qname); void characters(const XMLChar ch[], int start, int length); void ignorableWhitespace(const XMLChar ch[], int start, int length); void processingInstruction(const XMLString& target, const XMLString& data); void startPrefixMapping(const XMLString& prefix, const XMLString& uri); void endPrefixMapping(const XMLString& prefix); void skippedEntity(const XMLString& name); // LexicalHandler void startDTD(const XMLString& name, const XMLString& publicId, const XMLString& systemId); void endDTD(); void startEntity(const XMLString& name); void endEntity(const XMLString& name); void startCDATA(); void endCDATA(); void comment(const XMLChar ch[], int start, int length); void appendNode(AbstractNode* pNode); void setupParse(); private: static const XMLString EMPTY_STRING; XMLReader& _xmlReader; NamePool* _pNamePool; Document* _pDocument; AbstractContainerNode* _pParent; AbstractNode* _pPrevious; bool _inCDATA; bool _namespaces; }; } } // namespace Poco::XML #endif // DOM_DOMBuilder_INCLUDED