--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/persistentstorage/centralrepository/common/inc/setting.h Fri Jan 22 11:06:30 2010 +0200
@@ -0,0 +1,258 @@
+// 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