domparser.h

简单的xml解析类

//************************************************************************************************************************** 
//* Blue Xml Extension
//* Copyright (c) 2002-2004 Josh Harler
//* 
//* Blue - General Purpose C++ Library
//* Copyright (c) 2002-2004 Josh Harler
//* 
//* This software is provided 'as-is', without any express or implied warranty. In no event
//* will the authors be held liable for any damages arising from the use of this software.
//* 
//* Permission is granted to anyone to use this software for any purpose, including commercial
//* applications, and to alter it and redistribute it freely, subject to the following restrictions:
//* 
//* 	1. The origin of this software must not be misrepresented; you must not claim that you
//* 	wrote the original software. If you use this software in a product, an acknowledgment in the
//* 	product documentation would be appreciated but is not required.
//* 
//* 	2. Altered source versions must be plainly marked as such, and must not be misrepresented as
//* 	being the original software.
//* 
//* 	3. This notice may not be removed or altered from any source distribution.
//*
//*
//* file   Blue/Extension/Xml/DomParser.h
//**

#ifndef __blue_ext_xml_DomParser_h_included__
#define __blue_ext_xml_DomParser_h_included__

// Public Headers ==========================================================================================================

// Extension headers
#include "Blue/Extension/Xml/XmlParser.h"
#include "Blue/Extension/Xml/DomNodes.h"

// Blue library headers
#include "Blue/Common/Array.h"


// Public Defines/Enums/Typedefs/Etc. ======================================================================================

// Public Classes/Structs ==================================================================================================

namespace blue {
namespace ext {
namespace xml {

	/**
	 * \class DomParser
	 * \brief Parses the Xml document into a Dom tree.
	 * \ingroup Xml
	 *
	 * \sa DomNode, XmlParser, SaxParser
	 */
	class BLUE_EXPORT_XML DomParser :public XmlParser
	{
	public:
		// ===========================================================
		//  creation/destruction
		// ===========================================================

		/** Constructor. */
		DomParser();
		/** Constructor. */
		DomParser( data::InputStream* input );

		/** Destructor. */
		virtual ~DomParser();


		// ===========================================================
		//  query
		// ===========================================================

		/** Returns the top-level document node of the Xml document. */
		DomDocumentNode* getDocumentNode();
		/** overload. */
		const DomDocumentNode* getDocumentNode() const;


	private:
		/**
		 * Copy constructor. Private because DomParsers should not be
		 * manipulated by more than one instance.
		 */
		DomParser( const DomParser& );
		/** Private assignment operator. See copy constructor documentation. */
		const DomParser& operator=( const DomParser& );

		
		virtual void xmlReset();

		virtual void xmlDocumentBegin();
		virtual void xmlDocumentEnd();

		virtual void xmlProcInstBegin( String instruction );
		virtual void xmlProcInstAttribute( String name, String value );
		virtual void xmlProcInstEnd( String instruction );

		virtual void xmlElementBegin( String element );
		virtual void xmlElementAttribute( String name, String value );
		virtual void xmlElementText( String text );
		virtual void xmlElementCData( String cdata );
		virtual void xmlElementEnd( String element );

		virtual void xmlComment( String comment );


		DomDocumentNode* m_document;
		DomNode*         m_current;
	};


	/**
	 * \class DomParseException
	 * \brief Thrown when an error in the XML document is encountered
	 * \ingroup XmlExceptions
	 */
	class BLUE_EXPORT_XML DomParseException :public XmlException
	{
	public:
		DomParseException( String desc )
			:XmlException(desc) {}

		virtual String getException() const {
			return (String("DomParseException", String::STATIC));
		}
	};


}}}	// namespaces


// Public External Variables ===============================================================================================

// Public Function Prototypes ==============================================================================================

// Public Inline Functions =================================================================================================

#endif // include guard