os/persistentdata/persistentstorage/centralrepository/common/inc/heaprepos.h
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
sl@0
     1
// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     2
// All rights reserved.
sl@0
     3
// This component and the accompanying materials are made available
sl@0
     4
// under the terms of "Eclipse Public License v1.0"
sl@0
     5
// which accompanies this distribution, and is available
sl@0
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     7
//
sl@0
     8
// Initial Contributors:
sl@0
     9
// Nokia Corporation - initial contribution.
sl@0
    10
//
sl@0
    11
// Contributors:
sl@0
    12
//
sl@0
    13
// Description:
sl@0
    14
//
sl@0
    15
sl@0
    16
#ifndef HEAPREPOS_H_
sl@0
    17
#define HEAPREPOS_H_
sl@0
    18
sl@0
    19
#include <e32base.h>
sl@0
    20
#include "setting.h"
sl@0
    21
#include "datatype.h"
sl@0
    22
#include "cregen.h"
sl@0
    23
#include "inifile.h"
sl@0
    24
sl@0
    25
/**
sl@0
    26
@internalTechnology
sl@0
    27
*/
sl@0
    28
class CHeapRepository : public CBase
sl@0
    29
	{
sl@0
    30
	friend class CCreGenerator;
sl@0
    31
	friend class TConvToolTester;
sl@0
    32
	
sl@0
    33
public:	
sl@0
    34
	static CHeapRepository* NewL(TUid aUid);
sl@0
    35
	~CHeapRepository();
sl@0
    36
	void ResetContent();	
sl@0
    37
sl@0
    38
	//-------------general get/set function-------------------------------------
sl@0
    39
	TBool IsEmpty();
sl@0
    40
	inline TUid Uid() const {return iUid;};
sl@0
    41
	inline void SetUid(TUid aUid){iUid=aUid;};
sl@0
    42
	inline TUid Owner() {return iOwner ;} ;
sl@0
    43
	inline void SetOwner(TUid aOwner){iOwner=aOwner;};
sl@0
    44
	
sl@0
    45
	inline RSettingsArray& SettingsArray();
sl@0
    46
	inline RArray<TUint32>& DeletedSettingsArray();
sl@0
    47
	inline RPointerArray<TSettingsAccessPolicy>& SinglePolicyArray();
sl@0
    48
	inline RRangePolicyArray& RangePolicyArray();
sl@0
    49
	inline RDefaultMetaArray& RangeMetaArray();
sl@0
    50
	inline TUint32 DefaultMeta() {return iDefaultMeta;};
sl@0
    51
	inline void SetDefaultMeta(TUint32 aMeta){iDefaultMeta=aMeta;};
sl@0
    52
	
sl@0
    53
	inline TTime TimeStamp() const {return iTimeStamp;};
sl@0
    54
	inline void SetTimeStamp(const TTime& aTime){iTimeStamp=aTime;};
sl@0
    55
	
sl@0
    56
sl@0
    57
	//-------------security retrieval function-----------------------------
sl@0
    58
	static TBool SinglePolicyMatchOnKey(const TSettingsAccessPolicy& aSinglePolicy, const TSettingsAccessPolicy& aSinglePolicyIndexItem);
sl@0
    59
	static TInt CompareKeyIds(const TSettingsAccessPolicy& aSinglePolicy, const TSettingsAccessPolicy& aSinglePolicyIndexItem);	
sl@0
    60
	TSettingsAccessPolicy* GetFallbackAccessPolicy(TUint32 aId
sl@0
    61
#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS	
sl@0
    62
	,TBool aSkipSingle=EFalse
sl@0
    63
#endif	
sl@0
    64
	);
sl@0
    65
	const TSecurityPolicy& GetFallbackReadAccessPolicy(TUint32 aId);
sl@0
    66
	inline const TSecurityPolicy& GetReadAccessPolicy(const TServerSetting& aSetting);
sl@0
    67
	inline const TSecurityPolicy& GetReadAccessPolicy(TUint32 aId);
sl@0
    68
	inline const TSecurityPolicy& GetDefaultReadAccessPolicy();
sl@0
    69
	const TSecurityPolicy& GetFallbackWriteAccessPolicy(TUint32 aId);
sl@0
    70
	inline const TSecurityPolicy& GetWriteAccessPolicy(const TServerSetting& aSetting);
sl@0
    71
	inline const TSecurityPolicy& GetWriteAccessPolicy(TUint32 aId);
sl@0
    72
	inline const TSecurityPolicy& GetDefaultWriteAccessPolicy();
sl@0
    73
	inline void SetDefaultPolicy(const TSettingsAccessPolicy& aDefaultPolicy)
sl@0
    74
		{
sl@0
    75
		iDefaultPolicy.iReadAccessPolicy=aDefaultPolicy.iReadAccessPolicy;
sl@0
    76
		iDefaultPolicy.iWriteAccessPolicy=aDefaultPolicy.iWriteAccessPolicy;		
sl@0
    77
		}
sl@0
    78
	inline TSettingsAccessPolicy& GetDefaultAccessPolicy()
sl@0
    79
		{	
sl@0
    80
		return iDefaultPolicy;
sl@0
    81
		}
sl@0
    82
sl@0
    83
	//-------------file i/o cre read/write and ini read write---------------
sl@0
    84
	void ExternalizeCre(TUint8 aPersistVersion,RWriteStream& aStream) const;
sl@0
    85
	void InternalizeCreL(RReadStream& aStream) ;
sl@0
    86
	TInt CommitChanges(RFs& aFs,TUint8 aPersistVersion,const TDesC& aTargetFilePath);
sl@0
    87
	void CreateRepositoryFromCreFileL(RFs& aFs,const TDesC& aFilePath);
sl@0
    88
#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS	
sl@0
    89
	void CreateRepositoryFromCreFileL(RFs& aFs,const TDesC& aFilePath,TUint8& aCreVersion);	
sl@0
    90
	void InternalizeCreL(RReadStream& aStream,TUint8& aCreVersion)
sl@0
    91
		{
sl@0
    92
		CCreGenerator::InternalizeCreL(*this, aStream,aCreVersion);
sl@0
    93
		}
sl@0
    94
#endif			
sl@0
    95
	void ReloadContentL(CIniFileIn& aIniFile);
sl@0
    96
	TInt ReloadContentExceptSettingsL(CIniFileIn& aIniFile);
sl@0
    97
sl@0
    98
	void SetMetaDataOnRead(TServerSetting& aSetting, TBool aSingleMetaFound);
sl@0
    99
	static void SinglePoliciesCleanup(TAny *aPtr);	 
sl@0
   100
sl@0
   101
	TInt ReadSettingSavePolicyL(CIniFileIn& aFile,TServerSetting& aSetting, TSettingsAccessPolicy* &aPolicy, TBool& aSingleMetaFound);	
sl@0
   102
	TInt Create(TServerSetting& s, TSettingsAccessPolicy* &aPolicy, TBool aSingleMetaFound=EFalse);
sl@0
   103
sl@0
   104
	//only used for the conv tool so configured out here using macro	
sl@0
   105
#ifdef CENTREP_CONV_TOOL	
sl@0
   106
	void DoCommitChangesToIniFileL(RFs& aFs,const TDesC& aOutFileName
sl@0
   107
#ifdef SYMBIAN_CENTREP_SUPPORT_MULTIROFS
sl@0
   108
	,TUint32 aCreVersion
sl@0
   109
#endif	
sl@0
   110
	);
sl@0
   111
#endif
sl@0
   112
	
sl@0
   113
private:
sl@0
   114
	void DoCommitChangesL(RFs& aFs,TUint8 aPersistVersion,const TDesC& aFilePath);
sl@0
   115
	CHeapRepository(TUid aUid);
sl@0
   116
		
sl@0
   117
private:
sl@0
   118
	enum {KGranularity=8};
sl@0
   119
	RSettingsArray iSettings;
sl@0
   120
	TUid iUid;
sl@0
   121
	TUid iOwner;
sl@0
   122
		
sl@0
   123
	//security policy
sl@0
   124
	TSettingsAccessPolicy iDefaultPolicy;	
sl@0
   125
	RPointerArray<TSettingsAccessPolicy> iSinglePolicies;
sl@0
   126
	RRangePolicyArray iRangePolicies;
sl@0
   127
	
sl@0
   128
	//meta data
sl@0
   129
	TUint32 iDefaultMeta ;
sl@0
   130
	RDefaultMetaArray iRangeMeta ;
sl@0
   131
	
sl@0
   132
	// Keep track of deleted keys so that deletions can be propagated across
sl@0
   133
	// a Backup/Restore cycle when backup data is merged with initialisation
sl@0
   134
	// file during restore process.
sl@0
   135
	RArray<TUint32> iDeletedSettings ;
sl@0
   136
	TTime iTimeStamp;
sl@0
   137
	};
sl@0
   138
sl@0
   139
#include "heaprepos.inl"
sl@0
   140
sl@0
   141
#endif /*HEAPREPOS_H_*/