/*

* 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