// 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__