INTEGRATION: CWS desktintgr02 (1.1.2); FILE ADDED

2004/07/29 09:28:24 deuce 1.1.2.1: Issue number:  21110
Submitted by:  Gorden Lin {gorden.lin@sun.com}
Reviewed by:   Tino Rachui {tino.rachui@sun.com}

1 files changed, 184 insertions, 0 deletions

diff --git a/shell/inc/internal/metainforeader.hxx b/shell/inc/internal/metainforeader.hxx
new file mode 100644
index 000000000000..5ebca9589383
--- /dev/null
+++ b/shell/inc/internal/metainforeader.hxx
@@ -0,0 +1,184 @@
+/*************************************************************************
+ *
+ *  $RCSfile: metainforeader.hxx,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: hr $ $Date: 2004-09-08 14:23:38 $
+ *
+ *  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 METAINFOREADER_HXX_INCLUDED
+#define METAINFOREADER_HXX_INCLUDED
+
+#ifndef BASEREADER_HXX_INCLUDED
+#include "internal/basereader.hxx"
+#endif
+
+#ifndef TYPES_HXX_INCLUDED
+#include "internal/types.hxx"
+#endif
+
+class ITag;
+class CKeywordsTag;
+class CSimpleTag;
+class CDummyTag;
+
+class CMetaInfoReader : public CBaseReader
+{
+public:
+    virtual ~CMetaInfoReader();
+
+    CMetaInfoReader( const std::string& DocumentName );
+    /** check if the Tag is in the target meta.xml file.
+
+        @param TagName
+        the name of the tag that will be retrive.
+    */
+    bool hasTag(std::wstring TagName) const;
+
+
+    /** Get a specific tag content, compound tags will be returned as comma separated list.
+
+        @param TagName
+        the name of the tag that will be retrive.
+    */
+    std::wstring getTagData( const std::wstring& TagName);
+
+    /** check if the a tag has the specific attribute.
+
+        @param TagName
+        the name of the tag.
+        @param AttributeName
+        the name of the attribute.
+    */
+    bool hasTagAttribute( const std::wstring TagName,  std::wstring AttributeName);
+
+    /** Get a specific attribute content.
+
+        @param TagName
+        the name of the tag.
+        @param AttributeName
+        the name of the attribute.
+    */
+    std::wstring getTagAttribute( const std::wstring TagName,  std::wstring AttributeName);
+
+    /** Get the default language of the whole document.
+    */
+    LocaleSet_t getDefaultLocale( );
+
+protected: // protected because its only an implementation relevant class
+
+    /** start_element occurs when a tag is start.
+
+        @param raw_name
+        raw name of the tag.
+        @param local_name
+        local name of the tag.
+        @param attributes
+        attribute structure.
+    */
+    virtual void start_element(
+        const std::wstring& raw_name,
+        const std::wstring& local_name,
+        const XmlTagAttributes_t& attributes);
+
+    /** end_element occurs when a tag is closed
+
+        @param raw_name
+        raw name of the tag.
+        @param local_name
+        local name of the tag.
+    */
+    virtual void end_element(
+        const std::wstring& raw_name, const std::wstring& local_name);
+
+    /** characters occurs when receiving characters
+
+        @param character
+        content of the information received.
+    */
+    virtual void characters(const std::wstring& character);
+
+protected:
+    /** choose an appropriate tag reader to handle the tag.
+
+        @param tag_name
+        the name of the tag.
+        @param XmlAttributes
+        attribute structure of the tag to save in.
+    */
+    ITag* chooseTagReader(
+        const std::wstring& tag_name, const XmlTagAttributes_t& XmlAttributes );
+
+    /** save the received content into structure.
+
+        @param tag_name
+        the name of the tag.
+    */
+    void saveTagContent( const std::wstring& tag_name );
+
+private:
+    XmlTags_t      m_AllMetaInfo;
+
+private:
+    std::stack<ITag*> m_TagBuilderStack;
+
+private:
+    CKeywordsTag* m_pKeywords_Builder;
+    CDummyTag*   m_pDummy_Builder;
+    CSimpleTag* m_pSimple_Builder;
+};
+
+#endif
\ No newline at end of file