--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/languageinterworkingfw/servicehandler/inc/liwxmlhandler.h	Mon Mar 30 12:51:20 2009 +0300
@@ -0,0 +1,184 @@
+/*
+* Copyright (c) 2003-2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:       Wrapper to XML parser interface. Loads the inline and external XML metadata
+*				 				 and populates the service provider metadata information. This class
+*				 				 uses Symbian SAX parser to load the metadata information.
+*
+*/
+
+
+
+
+
+
+
+#ifndef LIW_XMLHANDLER_H
+#define LIW_XMLHANDLER_H
+
+#include <SenXmlReader.h>
+#include <MSenContentHandlerClient.h>
+#include <xml/ContentHandler.h>
+#include <e32capability.h>
+
+// CONSTANTS
+const TInt KMaxBufLen = 255;
+
+// MACROS
+
+// DATA TYPES
+
+// FUNCTION PROTOTYPES
+
+// FORWARD DECLARATIONS
+class CLiwServiceData;
+class CLiwList;
+
+/**
+* Wrapper class for XML parser. This class is used to parse inline
+* and file-based external metadata definitions. SAX (Simple API for XML)
+* parser is used to parse the XML content.
+*
+* @lib ServiceHandler.lib
+*
+* @see MSenContentHandlerClient
+* @see CSenXmlReader
+* @see CLiwServiceData
+**/
+class CLiwXmlHandler : public CBase, public MSenContentHandlerClient
+{
+public:
+	
+	/*
+	 * Creates and returns an instance of \c CLiwXmlHandler
+	 *
+	 * @return an instance of \c CLiwXmlHandler
+	 */
+	static CLiwXmlHandler* NewL();
+	
+	/*
+	 * Creates and returns an instance of \c CLiwXmlHandler
+	 * Leaves the created instance in the cleanupstack.
+	 *
+	 * @return an instance of \c CLiwXmlHandler
+	 */
+	static CLiwXmlHandler* NewLC();
+	
+	/*
+	 * Destructor
+	 */
+	virtual ~CLiwXmlHandler();
+	
+	/**
+	* Receive notification of the beginning of a document.
+	* @return KErrNone or some of the system-wide Symbian error codes.
+	*/		
+	virtual TInt StartDocument();
+
+	/**
+	* Receive notification of the end of a document.
+	* @return KErrNone or some of the system-wide Symbian error codes.
+	*/
+	virtual TInt EndDocument();
+	
+	/**
+	* Receive notification of the start of an element.
+	* @return KErrNone or some of the system-wide Symbian error codes.
+	*/
+	virtual TInt StartElement(	const TDesC8& /*aURI*/, 
+										const TDesC8& /*aLocalName*/, 
+										const TDesC8& /*aName*/, 
+										const RAttributeArray& /* apAttrs */);
+
+	/**
+	* Receive notification of the end of an element.
+	* @return KErrNone or some of the system-wide Symbian error codes.
+	*/
+	virtual TInt EndElement(	const TDesC8& /*aURI*/, 
+									const TDesC8& /*aLocalName*/, 
+									const TDesC8& /*aName*/);
+	/**
+	* Receive notification of the character data found in the XML document.
+	* @return KErrNone or some of the system-wide Symbian error codes.
+	*/
+	virtual TInt Characters(const TDesC8& /*aBuf*/, 
+	   							   const TInt /*aStart*/, 
+								   const TInt /*aLength*/);
+	
+	/**
+	 * Called when there is an error in parsing.
+	 * @return KErrNone or some of the system-wide Symbian error codes.
+	*/
+	inline virtual TInt Error(TInt /*aErrorCode*/);
+		
+	/**
+    * Loads service data from an external file specified 
+    * in aFileToParse parameter.
+    *
+    * @param aFileToParse a valid well defined XML file having metadata definition 
+    * @param aServiceData service data to be populated with service provider information. 
+    *  					  The caller should pass a properly instantiated pointer to CLiwServiceData instance
+    *
+    * @return KErrNone if the loading of service data is successful
+    		  KSrvDataLoadFailed if the loading of XML file failed
+    */				
+	TInt LoadServiceData(const TDesC& aFileToParse, CLiwServiceData* aServiceData);
+	
+	/**
+    * Loads service data from a XML data buffer. The passed XML data buffer
+    * should be well defined and well formatted valid XML content.
+    *
+    * @param aXmlBuffer a valid well defined and well formatted XML data content
+    * @param aServiceData service data to be populated with service provider information. 
+    *  					  The caller should pass a properly instantiated pointer to CLiwServiceData instance
+    *
+    * @return KErrNone if the loading of service data is successful
+    		  KSrvDataLoadFailed if the loading of XML buffer content failed
+    */
+	TInt LoadServiceData(const TDesC8& aXmlBuffer, CLiwServiceData* aServiceData);
+	
+	/*
+     * Enumeration IDs corresponding to XML parsing status
+     */ 
+	enum TLiwXmlParseStatus
+	{
+		ESrvDataLoadSuccess=0, 
+		ESrvDataLoadFailed,	//General failures other than below
+		ESrvDataFileNotFnd, 
+		ESrvDataInvalidFile, //Parse error
+		ESrvDataCapNotSpecified	
+	};
+												
+private:
+
+	//private default constructor
+	CLiwXmlHandler();
+	
+	//second phase constructor
+	void ConstructL();
+	
+	//the SAX parser instance
+	CSenXmlReader* iXmlHandler;	
+	
+	//the service data instance to be populated with metadata information
+	CLiwServiceData* iServiceData;
+	
+	HBufC8* iBuffer;
+	TBuf8<KMaxBufLen> startBuf;
+};
+
+#endif 
+
+// End of File
+
+