/*

* Copyright (c) 2008-2010 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: 

* CScrXmlParser - Used to retrieve details from xml files for creating database and 

* Software environment updates.

*

*/

/**

 @file 

 @released

 @internalTechnology

*/

#ifndef XMLPARSER_H

#define XMLPARSER_H

#pragma warning(disable: 4786)

#pragma warning(disable: 4291)

#include <vector>

#include <string>

#include <xercesc/parsers/XercesDOMParser.hpp>

#include <xercesc/sax/ErrorHandler.hpp>

#include <xercesc/dom/DOM.hpp>

#include "toolsconf.h"

#include "symbiantypes.h"

#include "utf8_wrapper.h"

// Xerces library uses XMLCh (UTF16 format) as its default character type.

// We can store the UTF16 returned form the xerces library in the following

// template class.

typedef std::basic_string<XMLCh> XercesString;

/**

* This template is used to cleanup memory by calling a function as pointed 

* by the first parameter as a function parameter. It can be used only used

* with functions which take a pointer to a pointer as an argument. This is 

* currently a limitation as the xerces library takes the same to release 

* its own memory.

*/

template <typename tFnPtr, typename tPtr> class fn_auto_ptr 

	{

	public:

		explicit fn_auto_ptr(tFnPtr aFnPtr, tPtr* aPtr)

			: iFnPtr(aFnPtr),

			iPtr(aPtr)

		{}

		~fn_auto_ptr() { iFnPtr(&iPtr); }

		tPtr *get() const throw()

			{

			return (iPtr); 

			}

	private:

		tFnPtr iFnPtr;

		tPtr* iPtr;

	};

template <typename tFnPtr, typename tPtr> class mem_fn_auto_ptr 

	{

	public:

		explicit mem_fn_auto_ptr(tFnPtr aFnPtr, tPtr aPtr)

			: iFnPtr(aFnPtr),

			iPtr(aPtr)

			{}

		~mem_fn_auto_ptr() { (iPtr->*iFnPtr)(); }

		tPtr operator->() const throw()

			{

			return (get()); 

			}

		tPtr get() const throw()

			{

			return (iPtr); 

			}

	private:

		tFnPtr iFnPtr;

		tPtr iPtr;

	};

template <typename tFnPtr> class static_fn_auto_ptr 

	{

	public:

		explicit static_fn_auto_ptr(tFnPtr aFnPtr)

			: iFnPtr(aFnPtr)

			{}

		~static_fn_auto_ptr() { &iFnPtr; }

	private:

		tFnPtr iFnPtr;

	};

namespace XmlDetails

{

	struct TScrEnvironmentDetails

			{

		public:

			TScrEnvironmentDetails()

			:iSifPluginUid(0)

			{}

			class TLocalizedSoftwareTypeName

				{

			public:

				TLocalizedSoftwareTypeName()

				:iLocale(0)

				{}

				int iLocale;

				std::wstring iName;

				};

            class TCustomAcessList

				{

			public:

				TCustomAcessList()

				:iAccessMode(1)

				{}

				int iSecureId;

				int iAccessMode;;

				};

			std::wstring iUniqueSoftwareTypeName;

			std::vector<TLocalizedSoftwareTypeName> iLocalizedSoftwareTypeNames;

			int iSifPluginUid;

            std::wstring iLauncherExecutable;

			std::vector<TCustomAcessList> iCustomAcessList;

			std::vector<std::wstring> iMIMEDetails;

			}; // struct TScrEnvironmentDetails

	class TScrPreProvisionDetail

		{

	public:

		TScrPreProvisionDetail()

		{}

		class TComponentLocalizable

			{

		public:

			TComponentLocalizable()

			:iLocale(0)

			{}

		public: // public Functions

			inline XercesString Name();

			inline XercesString Vendor();

		public: // Member variables	

			int iLocale;

			std::wstring iName;

			std::wstring iVendor;

			}; // class TComponentLocalizable

		class TComponentProperty

			{

		public:

			TComponentProperty()

			:iLocale(0),

			iIsIntValue(false),

			iIsStr8Bit(false)

			{}

		public: // Member Functions

			inline XercesString Name();

			inline XercesString Value();

		public: // Member variables

			std::wstring iName;

			int iLocale;

			std::wstring iValue;

			bool iIsIntValue;

			int iIsStr8Bit;

			}; // class TComponentProperty

		class TComponentDependency

			{

		public:

			class TComponentDependencyDetail

				{

				public: // Member Functions

					inline XercesString SupplierId();

					inline XercesString FromVersion();

					inline XercesString ToVersion();

				public: // Member Variables

					std::wstring iSupplierId;

					std::wstring iFromVersion;

					std::wstring iToVersion;

				}; // class TComponentDependencyDetail

			public: // Member Functions

				inline XercesString DependentId();

			public: // Member Variables

				std::wstring iDependentId;

				std::vector<TComponentDependencyDetail>	iComponentDependencyList;

			}; // class TComponentDependency

		class TComponentFile

			{

			public:

			TComponentFile()

			{}

			struct TFileProperty

				{	

			public:

				TFileProperty()

				:iIsIntValue(false)

				{}

			public: // Member Functions

				inline XercesString Name();

				inline XercesString Value();

			public: // Member Variables

				std::wstring iName;

				std::wstring iValue;

				bool iIsIntValue;

				}; // struct TFileProperty

			public: // Member Functions

			inline XercesString Location();

			public: // Member Variables

			std::wstring iLocation;

			std::vector<TFileProperty> iFileProperties;

			}; // class TComponentFile

		class TComponentDetails

			{

			public:

			TComponentDetails()

			:iIsRomApplication(0),

			iIsRemovable(1),

			iSize(0),

			iScomoState(1),

			iOriginVerified(1),

			iIsHidden(0)

			{}

			class TVersion

				{

			public:

				TVersion()

				{}

			public:

				inline XercesString MajorVersion();

				inline XercesString MinorVersion();

				inline XercesString BuildVersion();

			public:

				std::wstring iMajor;

				std::wstring iMinor;

				std::wstring iBuild;

				}; // class TVersion

			public: // Member Functions

			inline XercesString GlobalId();

			int iIsRomApplication;

			int iIsRemovable;

			TInt64 iSize;

			int iScomoState;

			std::wstring iGlobalId;

			TVersion iVersion;

			int iOriginVerified;

			int iIsHidden;

			};

		class TApplicationRegistrationInfo

			{

			public:

				TApplicationRegistrationInfo()

				{}

				class TAppAttribute

					{

					public:

					TAppAttribute()

					:iIsIntValue(false),

					iIsStr8Bit(false)

					{}

					std::wstring iName;

					std::wstring iValue;

					bool iIsIntValue;

					int iIsStr8Bit;

					};

				class TDataType

					{

					public:

					TDataType()

					{}

					int iPriority;

					std::wstring iType;

					};

				class TOpaqueDataType

					{

					public:

					TOpaqueDataType()

					{}

					int iLocale;

					int iServiceUid;

					std::wstring iOpaqueData;

					};

				class TAppServiceInfo

					{

					public:

					TAppServiceInfo()

					{}

					int iUid;

					std::vector<TDataType> iDataType;

					};

				class TAppLocalizableInfo

					{

					public:

					TAppLocalizableInfo()

					{}

					class TLocalizableAttribute

						{

						public:

						TLocalizableAttribute()

						:iIsIntValue(false),

						iIsStr8Bit(false)

						{}

						std::wstring iName;

						std::wstring iValue;

						bool iIsIntValue;

						int iIsStr8Bit;

						};

					class TViewData

						{

						public:

						TViewData()

						{}

						class TViewDataAttributes

						{

						public:

						TViewDataAttributes()

						:iIsIntValue(false),

						iIsStr8Bit(false)

						{}

						std::wstring iName;

						std::wstring iValue;

						bool iIsIntValue;

						int iIsStr8Bit;

						};

						std::vector<TViewDataAttributes> iViewDataAttributes;

						};

					std::vector<TLocalizableAttribute> iLocalizableAttribute;

					std::vector<TViewData> iViewData;

					};

				class TAppProperty

					{

					public:

					TAppProperty()

					:iLocale(0),

					iIntValue(0)

					{}

					int iLocale;

					std::wstring iName;

					int iServiceUid;

					int iIntValue;

					std::wstring iStrValue;

					bool iIsStr8Bit;

					};

			std::vector<TAppAttribute> iApplicationAttribute;

			std::vector<std::wstring> iFileOwnershipInfo;

			std::vector<TAppServiceInfo> iApplicationServiceInfo;

			std::vector<TAppLocalizableInfo> iApplicationLocalizableInfo;

			std::vector<TAppProperty> iApplicationProperty;

			std::vector<TOpaqueDataType> iOpaqueDataType;

			};

		class TComponent

			{

			public:

			TComponent()

			:iComponentDetails()

			{}

			std::vector<TComponentLocalizable>	iComponentLocalizables;

			std::vector<TComponentProperty>		iComponentProperties;

			std::vector<TComponentFile>			iComponentFiles;

			TComponentDependency iComponentDependency;

			std::vector<TApplicationRegistrationInfo> iApplicationRegistrationInfo;

			TComponentDetails iComponentDetails;

			}; // class TComponent

		inline XercesString SoftwareTypeName();

		std::wstring iSoftwareTypeName;

		std::vector<TComponent> iComponents;

		}; // class TScrPreProvisionDetail

}

class CScrXmlParser

	{

	public:

		/**

		 * Initializes the xml parser and logging feature based on supplied logging parameters.

		 */

		DllExport CScrXmlParser();

		/**

		 * Frees allocated memory.

		 */

		DllExport ~CScrXmlParser();

		/**

		 * Retrieves the database schema for database creation, from the supplied database file. 

		 */

		DllExport std::vector<std::string>* ParseDbSchema(const std::string& aDbFile);

		/**

		 * Retrieves software environment details, from the supplied xml file. 

		 */

		DllExport std::vector<XmlDetails::TScrEnvironmentDetails>* GetEnvironmentDetails(const std::string aEnvDetailFile );

		XmlDetails::TScrPreProvisionDetail GetPreProvisionDetails( const std::string aPreProvisionFile );

	private:

		/**

		 * Called while retrieving s/w environment details. 

		 */

		XmlDetails::TScrEnvironmentDetails GetEnvironmentData( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponent GetPreProvisionData( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentLocalizable GetComponentLocalizable( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentProperty GetComponentProperty( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentFile GetComponentFile( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentDependency GetComponentDependency( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentFile::TFileProperty GetFileProperty( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TComponentDetails GetComponentDetails( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo GetApplicationRegistrationInfo(const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TAppAttribute GetAppAttribute( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		std::wstring GetFileOwnershipInfo( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TDataType GetDataType( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TOpaqueDataType GetOpaqueDataType( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TOpaqueDataType GetServiceOpaqueDataType( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TAppServiceInfo GetAppServiceInfo( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement, XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo& aAppRegistrationInfo);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TAppLocalizableInfo GetAppLocalizableInfo( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TAppLocalizableInfo::TLocalizableAttribute GetAppLocalizableAttribute( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);

		XmlDetails::TScrPreProvisionDetail::TApplicationRegistrationInfo::TAppLocalizableInfo::TViewData GetAppLocalizableViewData( const XERCES_CPP_NAMESPACE::DOMElement* aDOMElement);