// Copyright (c) 2004-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 SETTING_H

#define SETTING_H

#include <e32std.h>

#include <s32strm.h>

#include "centralrepository.h"

#include "srvdefs.h"

class TSettingsAccessPolicy;

/**

@internalTechnology

*/

class TServerSetting

	{

	friend class RSettingsArray;

#if defined(SYMBIAN_CENTREP_SUPPORT_MULTIROFS) && defined(CENTRAL_REPOSITORY_SERVER_TESTING)	

	friend class CenrepSrvOOMTest;

#endif	

public:

	enum TType { EInt	  = 0x00000000, 

				 EReal	  = 0x10000000, 

				 EString  = 0x20000000, 

				 EDeleted = 0x30000000 };

	inline TServerSetting();

	inline TServerSetting(TUint32 aKey);

	inline TInt ReplaceTypeAndValue(const TServerSetting& source);

	inline TInt Replace(const TServerSetting& source);

	inline TInt Transfer(TServerSetting& source);

	inline TUint32 Key() const;

	inline void SetKey(TUint32 aKey);

	inline TUint32 Meta() const;

	inline void SetMeta(const TUint32 aMeta);

	inline TBool IsClean(){return(iMeta & KMetaDefaultValue);};

	inline void SetClean(){iMeta |= KMetaDefaultValue;};

	inline void SetNotClean(){iMeta &=~KMetaDefaultValue;};

	inline TUint32 Type() const;

	inline void SetType(const TUint32 aType);

	inline TInt GetIntValue() const;

	inline const TReal& GetRealValue() const;

	inline const HBufC8* GetStrValue() const;

	inline void SetIntValue(TInt aVal);

	inline void SetRealValue(const TReal* aVal);

	inline void SetStrValue(const HBufC8* aVal);

	inline void SetDeleted();

	inline void CopyValueL(TInt aVal);

	inline void CopyValueL(const TReal& aVal);

	inline void CopyValueL(const TDesC8& aVal);

	inline TInt CopyValue(TInt aVal);

	inline TInt CopyValue(const TReal& aVal);

	inline TInt CopyValue(const TDesC8& aVal);		

	inline TInt AssignValueTo(TInt& aVal) const;

	inline TInt AssignValueTo(TReal& aVal) const;

	inline TInt AssignValueTo(TDes8& aVal) const;

	inline TInt AssignValueFrom(TInt aVal);

	inline TInt AssignValueFrom(const TReal& aVal);

	inline TInt AssignValueFrom(const TDesC8& aVal);

	inline void PushL() const;

	inline void Pop() const;

	inline void PopAndDestroy() const;	

	inline void Reset();

	inline void ResetValue();

	inline TInt operator==(const TServerSetting& aSetting) const;

	inline TInt operator==(TInt aVal) const;

	inline TInt operator==(const TReal& aVal) const;

	inline TInt operator==(const TDesC8& aVal) const;

	template <class T>

	inline TInt operator!=(const T& aVal) const

		{

		return !operator==(aVal);

		}

	inline TSettingsAccessPolicy* AccessPolicy() const;

	inline void SetAccessPolicy(TSettingsAccessPolicy* aPolicy);

	inline const TSecurityPolicy* GetReadAccessPolicy() const;

	inline const TSecurityPolicy* GetWriteAccessPolicy() const;

	inline TBool HasAccessPolicy() const;

	inline void ExternalizeL(RWriteStream& aStream) const;

	inline void InternalizeL(RReadStream& aStream);

	inline void ExternalizeMetaL(RWriteStream& aStream) const;

	inline void InternalizeMetaL(RReadStream& aStream);

	inline TBool IsType(const TInt&) const;

	inline TBool IsType(const TReal&) const;

	inline TBool IsType(const TDesC8&) const;

	inline TBool IsType(const TDesC16&) const;

	inline TBool IsInt() const;

	inline TBool IsReal() const;

	inline TBool IsStr() const;

	inline TBool IsDeleted() const;

#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS	

	inline TInt CopyTypeValue(const TServerSetting& source);

	inline void SetIndividualMeta(TBool aIndividualSettingMeta);

	inline TBool IsIndividualMeta() const {return (iMeta & KMetaIndividual);};

#endif	

private:

	TUint32 iKey;

	TUint32 iMeta;

	union TValue { TInt i; TReal* r; HBufC8* s; } iValue;

	// A bit of dilemma how to store TSecurePolicy for read/write access...

	// If we were implementing a list of policies per an entry then RArray would be an obvious choice,

	// but even then when no policy is specified each entry would have RArray (in compressed state 24B)

	// Or we could have two instances of TSecurePolicy (6B each)

	// so lets go for a link to a separate array of policies allocated only when needed

	TSettingsAccessPolicy* iAccessPolicy;

	};

/**

@internalTechnology

*/

class TSettingsAccessPolicy

	{

	friend class CSharedRepository;

	friend class CHeapRepository;

	friend class CIniFileOut;

#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS	

	friend class CObservable;

#endif

public:

	// Single entry type is maintained in a separate array

	// then the range type... to avoid duplicities

	enum {ESingleSettingPolicy,ERangeSettingsPolicy};

	inline TSettingsAccessPolicy(TSecurityPolicy& aReadPolicy,TSecurityPolicy& aWritePolicy,

								TUint32 aLowKey, TUint32 aHighKey, TUint32 aKeyMask=0);

	inline TSettingsAccessPolicy(TSecurityPolicy& aReadPolicy,TSecurityPolicy& aWritePolicy,

								TUint32 aKey);

	inline TBool IsInRange(TUint32 aKey) const;							

	inline const TSecurityPolicy* GetReadAccessPolicy() const;

	inline const TSecurityPolicy* GetWriteAccessPolicy() const;

	inline void ExternalizeL(RWriteStream& aStream) const;

	inline void InternalizeL(RReadStream& aStream) ;

	inline TSettingsAccessPolicy();

	inline TUint32 LowKey() const;

	inline TUint32 HighKey() const;

	inline TUint32 KeyMask() const;

#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS

	inline TBool operator==(const TSettingsAccessPolicy& aPolicy) const

		{

		return Mem::Compare((TUint8*)this,sizeof(TSettingsAccessPolicy),(TUint8*)(&aPolicy),sizeof(TSettingsAccessPolicy));

		}

#endif		

private:

	inline TSettingsAccessPolicy(TUint32 key);

private:

	// we can have 'duplicites' where a single policy would have the same key

	// as 'range' policy with the low key... 

	TUint32 iLowKey; // used as a key for single policy as well	

	/**

	for single key this is used to indicate whether read policy is specified or is default

	note this is only applies to single policy when SYMBIAN_CENTREP_SUPPORT_MULTIROFS is defined

	*/

	TUint32 iHighKey; // only used for Range

	/**

	for single key this is used to indicate whether write policy is specified or is default

	note this is only applies to single policy when SYMBIAN_CENTREP_SUPPORT_MULTIROFS is defined

	*/	

	TUint32 iKeyMask; // only used for Range

	TSecurityPolicy iReadAccessPolicy;

	TSecurityPolicy iWriteAccessPolicy;

	};

/**

@internalTechnology

*/

class TSettingsDefaultMeta

	{

	friend class CSharedRepository;

public:

	inline TSettingsDefaultMeta(TUint32 aValue, TUint32 aLowKey,

								TUint32 aHighKey, TUint32 aKeyMask=0);

	inline TBool IsInRange(TUint32 aKey) const;	

	inline TSettingsDefaultMeta();

	inline TUint32 GetDefaultMetadata() const 

	{

		return iDefaultMetaData ;

	};

	inline void ExternalizeL(RWriteStream& aStream) const;

	inline void InternalizeL(RReadStream& aStream) ;	

	inline TUint32 LowKey() const;

	inline TUint32 HighKey() const;

	inline TUint32 KeyMask() const;

#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS	

	inline TBool operator==(const TSettingsDefaultMeta& aMeta) const

		{

		return Mem::Compare((TUint8*)this,sizeof(TSettingsDefaultMeta),(TUint8*)(&aMeta),sizeof(TSettingsDefaultMeta));

		}

#endif

private:

	TUint32 iLowKey;

	TUint32 iHighKey;

	TUint32 iKeyMask;

	TUint32 iDefaultMetaData;

	};

/**

@internalTechnology

*/

class TSettingSingleMeta

	{

public:

	inline TSettingSingleMeta(TUint32 aKey, TUint32 aMeta);

	inline TUint32 GetKey() const { return iKey; }

	inline TUint32 GetMeta() const { return iMeta; }

private:

	TUint32 iKey;

	TUint32 iMeta;

	};

#include "setting.inl"

#endif // SETTING_H