xml/xmlparser/inc/CXMLObserver.h
changeset 27 450972dee096
child 37 c828a2f286d1
equal deleted inserted replaced
23:740e860b8acf 27:450972dee096
       
     1 /*
       
     2 * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
       
     3 * All rights reserved.
       
     4 * This component and the accompanying materials are made available
       
     5 * under the terms of the License "Eclipse Public License v1.0"
       
     6 * which accompanies this distribution, and is available
       
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 *
       
     9 * Initial Contributors:
       
    10 * Nokia Corporation - initial contribution.
       
    11 *
       
    12 * Contributors:
       
    13 *
       
    14 * Description:  ?Description
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 
       
    20 #ifndef __CXMLOBSERVER_H
       
    21 #define __CXMLOBSERVER_H
       
    22 
       
    23 //  INCLUDES
       
    24 #include <e32std.h>
       
    25 #include <txtetext.h>
       
    26 #include "CXMLAttributes.h"
       
    27 #include <xml/MXMLContentHandler.h>
       
    28 #include <xml/MWBXMLContentHandler.h>
       
    29 
       
    30 
       
    31 // CLASS DECLARATION
       
    32 
       
    33 /**
       
    34 *  Help class for CXMLReader.
       
    35 *  @lib XMLInterface.dll
       
    36 *  @since ?Series60_version
       
    37 */
       
    38 class CXMLObserver : public CBase
       
    39     {
       
    40 	public:  // Constructors and destructor
       
    41         
       
    42         /**
       
    43         * Two-phased constructor.
       
    44         */
       
    45         static CXMLObserver* NewL();
       
    46 
       
    47 		static CXMLObserver* NewLC();
       
    48         
       
    49         /**
       
    50         * Destructor.
       
    51         */
       
    52         ~CXMLObserver();
       
    53 
       
    54 public: // New functions
       
    55         
       
    56 /**
       
    57 * Registers content handler
       
    58 * @since ?Series60_version
       
    59 * @param aContentHandler: The ContentHandler to use.
       
    60 * @return none.
       
    61 */
       
    62 	inline void SetContentHandler(MXMLContentHandler* aContentHandler){iContentHandler = aContentHandler;}
       
    63 
       
    64 /**
       
    65 * Registers a binary content handler
       
    66 * @since ?Series60_version
       
    67 * @param aContentHandler: The ContentHandler to use.
       
    68 * @return none.
       
    69 */
       
    70 	inline void SetContentHandler(MWBXMLContentHandler* aContentHandler){iBinaryContentHandler = aContentHandler;}
       
    71 
       
    72 /**
       
    73 * Gets content handler
       
    74 * @since ?Series60_version
       
    75 * @param none.
       
    76 * @return ContentHandler.
       
    77 */
       
    78 	inline MXMLContentHandler* GetContentHandler(){return iContentHandler;}
       
    79 
       
    80 	/**
       
    81 * Gets binary content handler
       
    82 * @since ?Series60_version
       
    83 * @param none.
       
    84 * @return ContentHandler.
       
    85 */
       
    86 	inline MWBXMLContentHandler* GetBinaryContentHandler(){return iBinaryContentHandler;}
       
    87 
       
    88 
       
    89 /**
       
    90 * Gets current attribute list
       
    91 * @since ?Series60_version
       
    92 * @return pointer to current attribute list
       
    93 */
       
    94 	inline CXMLAttributes* GetAttributes(){return iAttributes;}
       
    95 
       
    96 /**
       
    97 * Get current element
       
    98 * @since ?Series60_version
       
    99 * @return Current element
       
   100 */
       
   101 	TPtrC GetElement() const;
       
   102 
       
   103 /**
       
   104 * Set current element
       
   105 * @since ?Series60_version
       
   106 * @param Current element
       
   107 * @return none.
       
   108 */
       
   109 	void SetElementL(const TPtrC &aName);
       
   110 
       
   111 /**
       
   112 * Remove current element
       
   113 * @since ?Series60_version
       
   114 * @return none
       
   115 */
       
   116 	void RemoveElement();
       
   117 
       
   118 /**
       
   119 * Set element URI
       
   120 * @since ?Series60_version
       
   121 * @param aURI: the URI.
       
   122 * @param aNSextension: namespace extension mapped to aURI.
       
   123 * @return none
       
   124 */
       
   125 	void SetURIL(const TPtrC &aURI, const TPtrC &aNSextension);
       
   126 
       
   127 /**
       
   128 * Get element URI
       
   129 * @since ?Series60_version
       
   130 * @param aNSextension: namespace extension mapped to aURI.
       
   131 * @return the URI.
       
   132 */
       
   133 	TPtrC GetURI(const TPtrC &aNSextension) const;
       
   134 
       
   135 /**
       
   136 * ResetURI, reset URI list
       
   137 * @since ?Series60_version
       
   138 * @return none.
       
   139 */
       
   140 	void ResetURI();
       
   141 
       
   142 
       
   143 private:
       
   144 /**
       
   145 * C++ default constructor.
       
   146 */
       
   147 	CXMLObserver(); 
       
   148 	
       
   149 	void ConstructL();
       
   150 
       
   151 public:	   // Data
       
   152 	// Keeps current attribute name
       
   153 	TPtrC* iCurrentAttribute;	
       
   154 
       
   155 private:  // Data
       
   156 	// Parser CallBacks
       
   157 	MXMLContentHandler* iContentHandler;
       
   158 	// Binary call backs
       
   159 	MWBXMLContentHandler* iBinaryContentHandler;
       
   160 	// Current attribute list
       
   161 	CXMLAttributes* iAttributes;
       
   162 	// Keeps track of elements (needed for binary parsing)
       
   163 	CDesCArraySeg* iDescElements;
       
   164 
       
   165 	// Keep track off namespace extensions and URIs.
       
   166 	CDesCArraySeg* iNSextensions;
       
   167 	CDesCArraySeg* iURIs;
       
   168 };
       
   169 
       
   170 #endif      // __CXMLOBSERVER_H   
       
   171             
       
   172 // End of File