// 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 __MSVCACHEENTRY_H__
#define __MSVCACHEENTRY_H__

#include "MSVTIME.H"
#include "MSVPANIC.H"

#include <e32base.h>
#include <msvstd.h>

/**
CMsvCacheEntry corresponds to a TMsvEntry object that has been loaded into memory.
@internalComponent
@prototype
*/

NONSHARABLE_CLASS (CMsvCacheEntry): public CBase
{
public:
	inline TMsvEntry& Entry();
	inline TMsvId GetId() const;
	
	TInt LockEntry();
	inline TBool IsEntryLocked() const;
	inline void ReleaseEntry();
	
	TInt LockStore();
	inline TBool IsStoreLocked() const;
	inline void ReleaseStore();
	
	inline TBool IsStoreReadingLocked() const;
	inline void IncStoreReaderCount();
	inline void DecStoreReaderCount();

	TInt LockEntryAndStore();
	inline TBool IsEntryOrStoreLocked() const;
	inline TBool IsEntryAndStoreLocked() const;
	inline void ReleaseEntryAndStore();
	
	inline const TMsvTime& CreatedDate() const;
	inline void SetCreatedDate(const TMsvTime& aTime);
	inline const TMsvTime& LastChangeDate() const;
	inline void SetLastChangeDate(const TMsvTime& aTime);

	void CopyEntryL(const TMsvEntry& aEntry, TBool& aChangedPrivateInfo);
	void RollBackCopyEntry(const TMsvEntry& aEntry);
	
	inline TSecureId EntryOwnerId() const;
	inline void SetEntryOwnerId(TSecureId aOwnerId);
	
	inline RArray<TMsvId>* ChildIdArray();
	inline void SetChildIdArray(RArray<TMsvId>* aChildArray);
	
	inline TBool IsEntrySwappable() const;
	
	void DupNDestroyL(CMsvCacheEntry*& aEntry);
	void SetEntryL(TMsvEntry& aEntry);
	void ResetEntry();
	
private:
	static CMsvCacheEntry* NewLC(); 
	static CMsvCacheEntry* NewL(); 
	void ConstructL();
	CMsvCacheEntry();
	CMsvCacheEntry(const CMsvCacheEntry&);
	virtual ~CMsvCacheEntry();
	
private:
	enum 
		{
		EMsvServerEntryClearFlag		= 0x00,
		EMsvServerEntryLockFlag			= 0x01,
		EMsvServerEntryStoreLockFlag	= 0x02
		};

	// Only CMsvEntryFreePool class should
	// create an instance of CMsvCacheEntry.
	friend class CMsvEntryFreePool;
	// This class is made friend because
	// we need to destroy entry through ResetAndDestroy().
	friend class RPointerArray<CMsvCacheEntry>;
	
#ifdef SYMBIAN_MESSAGESTORE_UNIT_TESTCODE
	friend class CTestCacheEntry;
#endif
	
public:
	HBufC* 		iDescriptionBuffer;
	HBufC* 		iDetailsBuffer;

private:	
	TMsvEntry	iEntry;
	TUint32		iFlags;
	TInt32		iStoreReaderCount;
	TMsvTime	iLastChange;
	TMsvTime	iCreated;
	TSecureId	iOwnerId;
	RArray<TMsvId>* iChildIdArray;
};

#include "msvcacheentry.inl"

#endif    // #ifndef __MSVCACHEENTRY_H__