// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of "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:

 //

 #ifndef __PARSEIMPLEMENTATIONDATA_H__

 #define __PARSEIMPLEMENTATIONDATA_H__

 #include <e32base.h>

 #include <barsread2.h> // RResourceReader

 #include <ecom/implementationinformation.h>

 /**

 Granularity of the extended interface array

 @internalComponent

 */

 const TInt KExtendedInterfaceGranularity = 1;

 /**

 Maximum number of interfaces info structures in resource file version 3. 

 @internalComponent

 */

 const TInt KMaxInterfacesInResV3 = 4;

 /**

 Maximum number of implementations in one interface info structures in resource file version 3. 

 @internalComponent

 */

 const TInt KMaxImplementationsForEachInterfacesInResV3 = 8;

 /** 

 Max length of default data and opaque data in resource file version 3.

 @internalComponent

 */

 const TInt KRscDataMaxLength = 512;

 /** 

 Resource string max length - see the limitations of BAFLS component, RResourceReader class.

 @see RResourceReader::ReadHBufCL()

 @internalComponent

 */

 const TInt KRscStringMaxLength = 255;

 /** 

 Maximum number of resource string for default_data and opaque_data in resource file version 3. 

 @internalComponent

 */

 const TInt KRscMaxNumberOfString = 2;

 /** 

 Maximum number of extended interfaces in one implementation in resource file version 3. 

 @internalComponent

 */

 const TInt KRscMaxExtendedInterfaces = 8;

 //

 // ParseImplementationData class

 /**

 This class facilitates parsing implementation data from the resource file.

 @internalComponent

 */

 class CParseImplementationData : public CBase

 	{

 public:

 	static CParseImplementationData* NewL(TInt aResourceFormatVersion);

 	static CParseImplementationData* NewLC(TInt aResourceFormatVersion);

 	virtual ~CParseImplementationData();

 	/**

 	Parsing the implementation information structure for resource file.

 	@param			aReader The resource file reader.

 	@param			aInfoFormat The integer identifying Implementation Information record type to be filled. 

 	@param			aImplementationUid The implementation Uid to be filled.

 	@param			aVersionNo	The version no to be filled.

 	@param			aName The pointer points to the buffer for display name to be filled in.

 	@param			aDefaultData The pointer points to the buffer for default data to be filled in.

 	@param			aOpaqueData The pointer points to the buffer for opaque data to be filled in.

 	@param			aExtendedInterfaces The pointer points to the array for extended interfaces to be filled in. 

 	@param			aRomOnly The rom only flag to be filled in.

 	*/

 	virtual void ParseL(RResourceReader& aReader,

 				   		TInt& aInfoFormat,

 				   		TUid& aImplementationUid,

 				   		TInt& aVersionNo,

 				   		HBufC*& aName,

 				   		HBufC8*& aDefaultData,

 				   		HBufC8*& aOpaqueData,

 				   		RExtendedInterfacesArray*& aExtendedInterfaces,

 				   		TBool& aRomOnly) = 0;

 protected:

 	CParseImplementationData();

 	void GetDataLC(RResourceReader& aReader,HBufC*& aData);

 	void GetDataLC(RResourceReader& aReader,HBufC8*& aData);

 	};

 //

 // CParseImplementationDataFormatVersion1 class

 /**

 This class facilitates parsing implementation data from the resource file version 1.

 @internalComponent

 */

 class CParseImplementationDataFormatVersion1 : public CParseImplementationData

 {

 public:

 	static CParseImplementationDataFormatVersion1* NewL();

 	void ParseL(RResourceReader& aReader,

 		   TInt& /*aInfoFormat*/,

 		   TUid& aImplementationUid,

 		   TInt& aVersionNo,

 		   HBufC*& aName,

 		   HBufC8*& aDefaultData,

 		   HBufC8*& aOpaqueData,

 		   RExtendedInterfacesArray*& /*aExtendedInterfaces*/,

 		   TBool& aRomOnly);

 private:

 	CParseImplementationDataFormatVersion1();

 };

 //

 // CParseImplementationDataFormatVersion2 class

 /**

 This class facilitates parsing implementation data from the resource file version 2.

 @internalComponent

 */	

 class CParseImplementationDataFormatVersion2 : public CParseImplementationData

 {

 public:

 	static CParseImplementationDataFormatVersion2* NewL();

 	void ParseL(RResourceReader& aReader,

 		   TInt& /*aInfoFormat*/,

 		   TUid& aImplementationUid,

 		   TInt& aVersionNo,

 		   HBufC*& aName,

 		   HBufC8*& aDefaultData,

 		   HBufC8*& aOpaqueData,

 		   RExtendedInterfacesArray*& /*aExtendedInterfaces*/,

 		   TBool& aRomOnly);

 private:

 	CParseImplementationDataFormatVersion2();

 };	

 //

 // CParseImplementationDataFormatVersion3 class

 /**

 This class facilitates parsing implementation data from the resource file version 3.

 @internalComponent

 */

 class CParseImplementationDataFormatVersion3 : public CParseImplementationData

 {

 public:

 	static CParseImplementationDataFormatVersion3* NewL();

 	void ParseL(RResourceReader& aReader,

 		   TInt& aInfoFormat,

 		   TUid& aImplementationUid,

 		   TInt& aVersionNo,

 		   HBufC*& aName,

 		   HBufC8*& aDefaultData,

 		   HBufC8*& aOpaqueData,

 		   RExtendedInterfacesArray*& aExtendedInterfaces,

 		   TBool& aRomOnly);

 private:

 	CParseImplementationDataFormatVersion3();

 	static TInt CompareUid(const TUid& aUid1, const TUid& aUid2);

 	void GetDataType1LC(RResourceReader& aReader,HBufC8*& aData);

 	void GetDataType2LC(RResourceReader& aReader,HBufC8*& aData);

 	void GetExtendedInterfacesLC(RResourceReader& aReader, RExtendedInterfacesArray*& aExtendedInterfaces);

 };

 #endif //__PARSEIMPLEMENTATIONDATA_H__