CCV - Hand Tracking Module

//

// DOMBuilder.h

//

// $Id: //poco/1.3/XML/include/Poco/DOM/DOMBuilder.h#2 $

//

// 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