INTEGRATION: CWS geordi2q06 (1.1.4); FILE ADDED

2003/09/24 11:36:03 rt 1.1.4.1: #111934#: join CWS recentdocs

1 files changed, 182 insertions, 0 deletions

diff --git a/shell/inc/internal/xml_parser.hxx b/shell/inc/internal/xml_parser.hxx
new file mode 100644
index 000000000000..28c9b75112b6
--- /dev/null
+++ b/shell/inc/internal/xml_parser.hxx
@@ -0,0 +1,182 @@
+/*************************************************************************
+ *
+ *  $RCSfile: xml_parser.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: hr $ $Date: 2003-09-29 14:53:34 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+#ifndef _XML_PARSER_HXX_
+#define _XML_PARSER_HXX_
+
+#include <external/expat/xmlparse.h>
+#include <stdexcept>
+
+//-----------------------------------------------------
+class xml_parser_exception //: public std::runtime_error
+{
+public:
+
+    xml_parser_exception(
+        const XML_Char* error_msg,
+        int error_code,
+        int line_number,
+        int column_number,
+        long byte_index) :
+        /*std::runtime_error(error_msg),*/
+        error_code_(error_code),
+        line_number_(line_number),
+        column_number_(column_number),
+        byte_index_(byte_index)
+    {}
+
+    int  error_code_;
+    int  line_number_;
+    int  column_number_;
+    long byte_index_;
+};
+
+
+//-----------------------------------------------------
+//  Simple wrapper around expat, the xml parser library
+//  created by James Clark
+//-----------------------------------------------------
+class i_xml_parser_event_handler;
+
+class xml_parser
+{
+public:
+    //########################################################
+    xml_parser(const XML_Char* EncodingName = 0);
+
+    //########################################################
+    xml_parser(const XML_Char* EncodingName, XML_Char NamespaceSeparator);
+
+    //########################################################
+    ~xml_parser();
+
+    //########################################################
+    /** Parse a XML data stream
+
+        @param      pXmlData
+                    Pointer to a buffer containing the xml data
+
+        @param      Length
+                    Length of the buffer containing the xml data
+
+        @param      IsFinal
+                    Indicates whether these are the last xml data
+                    of an xml document to parse. For very large
+                    xml documents it may be usefull to read and
+                    parse the document partially.
+
+        @precond    XmlData must not be null
+
+        @throws     SaxException
+                    If the used Sax parser returns an error. The SaxException
+                    contains detailed information about the error.  */
+    void parse(const char* XmlData, size_t Length, bool IsFinal = true);
+
+    //########################################################
+    /** Set a document handler
+
+        @descr      A document handler implements the interface ISaxDocumentHandler.
+                    The document handler receive notifications of various events
+                    from the sax parser for instance "StartDocument".
+
+                    The client is responsible for the life time management of
+                    the given document handler, that means the document handler
+                    instance must exist until a new one was set or until the parser
+                    no longer exist.
+
+        @param      SaxDocumentHandler
+                    The new document handler, may be null if not interessted in
+                    sax parser events.
+
+        @postcond   currently used document handler == pSaxDocumentHandler  */
+    void set_document_handler(i_xml_parser_event_handler* event_handler);
+
+    //########################################################
+    /** Returns the currently used document handler or null if
+        no document handler was set before. */
+    i_xml_parser_event_handler* get_document_handler() const;
+
+    //############################################
+    void set_encoding(const XML_Char* Encoding);
+
+private:
+
+    void init();
+
+    //####################################
+    // callback functions
+    static void xml_start_element_handler(void* UserData, const XML_Char* name, const XML_Char** atts);
+    static void xml_end_element_handler(void* UserData, const XML_Char* name);
+    static void xml_character_data_handler(void* UserData, const XML_Char* s, int len);
+    static void xml_comment_handler(void* UserData, const XML_Char* Data);
+
+private:
+    i_xml_parser_event_handler* document_handler_;
+    XML_Parser xml_parser_;
+
+// prevent copy and assignment
+private:
+    xml_parser(const xml_parser&);
+    xml_parser& operator=(const xml_parser&);
+};
+
+#endif
+