sl@0: // Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #if !defined(__S32STD_H__)
sl@0: #define __S32STD_H__
sl@0: #if !defined(__S32STRM_H__)
sl@0: #include <s32strm.h>
sl@0: #endif
sl@0: 
sl@0: /** The value of the null stream ID. */
sl@0: const TUint32 KNullStreamIdValue=0;
sl@0: const TUint32 KMaxStreamIdValue=0xfffffff;
sl@0: const TUint32 KMaskStreamIdValue=0xfffffff;
sl@0: const TInt KShiftStreamIdValue=28;
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Provides unique identification for stream within a store.
sl@0: 
sl@0: A store always assigns a new id and constructs and returns an associated TStreamId 
sl@0: object when a new stream is created.
sl@0: 
sl@0: @see RStoreWriteStream::CreateL()
sl@0: @see RStoreWriteStream::CreateLC()  
sl@0: */
sl@0: class TStreamId
sl@0: 	{
sl@0: public:
sl@0: 	/** Constructs an uninitialised object. It is necessary because there are also 
sl@0: 	non-default constructors in this class. */
sl@0: 	TStreamId() {}
sl@0: 	inline TStreamId(TUint32 aValue);
sl@0: //
sl@0: 	inline TBool operator==(TStreamId anId) const;
sl@0: 	inline TBool operator!=(TStreamId anId) const;
sl@0: //
sl@0: 	inline void ExternalizeL(RWriteStream& aStream) const;
sl@0: 	IMPORT_C void InternalizeL(RReadStream& aStream);
sl@0: //
sl@0: 	inline TUint32 Value() const;
sl@0: private:
sl@0: 	TUint32 iVal;
sl@0: private:
sl@0: 	IMPORT_C static void __DbgChkRange(TUint32 aValue);
sl@0: 	};
sl@0: #if defined(__NO_CLASS_CONSTS__)
sl@0: #define KNullStreamId TStreamId(KNullStreamIdValue)
sl@0: #else
sl@0: /** The null stream ID; this is a stream ID which is guaranteed not to exist. */
sl@0: const TStreamId KNullStreamId=TStreamId(KNullStreamIdValue);
sl@0: #endif
sl@0: //
sl@0: class CStreamStore;
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Supports the opening and manipulation of an existing stream in a store.  
sl@0: */
sl@0: class RStoreReadStream : public RReadStream
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C void OpenL(const CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void OpenLC(const CStreamStore& aStore,TStreamId anId);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Supports the writing of a stream to a store.
sl@0: 
sl@0: The class allows:
sl@0: 
sl@0: creation of a new stream
sl@0: 
sl@0: overwriting of an existing stream
sl@0: 
sl@0: replacement of an existing stream
sl@0: 
sl@0: appending to an existing stream 
sl@0: */
sl@0: class RStoreWriteStream : public RWriteStream
sl@0: 	{
sl@0: public:
sl@0: 	/** Constructs an uninitialised object. It is necessary because there are also 
sl@0: 	non-default constructors in this class. */
sl@0: 	RStoreWriteStream() {}
sl@0: 	inline RStoreWriteStream(const MExternalizer<TStreamRef>& anExter);
sl@0: 	IMPORT_C TStreamId CreateL(CStreamStore& aStore);
sl@0: 	IMPORT_C TStreamId CreateLC(CStreamStore& aStore);
sl@0: 	IMPORT_C void OpenL(CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void OpenLC(CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void ReplaceL(CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void ReplaceLC(CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void AppendL(CStreamStore& aStore,TStreamId anId);
sl@0: 	IMPORT_C void AppendLC(CStreamStore& aStore,TStreamId anId);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Base class for swizzles.
sl@0: 
sl@0: A swizzle maintains a dual representation for an object:
sl@0: 
sl@0: by stream id, if the object is not in memory (the stream contains the external 
sl@0: representation of that object).
sl@0: 
sl@0: by pointer, if the object is in memory.
sl@0: 
sl@0: The class is not intended for instantiation. 
sl@0: */
sl@0: class TSwizzleCBase
sl@0: 	{
sl@0: public:
sl@0: 	inline TBool operator==(const TSwizzleCBase& aSwizzle) const;
sl@0: 	inline TBool operator==(const TAny* aPtr) const;
sl@0: 	inline TBool operator!=(const TSwizzleCBase& aSwizzle) const;
sl@0: 	inline TBool operator!=(const TAny* aPtr) const;
sl@0: //
sl@0: 	inline TBool IsPtr() const;
sl@0: 	inline TBool IsId() const;
sl@0: 	IMPORT_C TStreamId AsId() const;
sl@0: 	IMPORT_C void InternalizeL(RReadStream& aStream);
sl@0: protected:
sl@0: 	TSwizzleCBase() {}
sl@0: 	inline TSwizzleCBase(const TAny* aPtr);
sl@0: 	IMPORT_C TSwizzleCBase(TStreamId anId);
sl@0: 	inline TSwizzleCBase(TStreamRef aRef);
sl@0: 	inline const TAny* Ptr() const;
sl@0: 	IMPORT_C void DoExternalizeL(RWriteStream& aStream,TExternalizer<TAny> anExter) const;
sl@0: private:
sl@0: 	IMPORT_C static TBool IsPtrRep(const TAny* aPtr);
sl@0: 	IMPORT_C static TBool IsIdRep(const TAny* aPtr);
sl@0: private:
sl@0: 	const TAny* iPtr;
sl@0: private:
sl@0: 	IMPORT_C static void __DbgChkPtr(const TAny* aPtr);
sl@0: 	IMPORT_C static void __DbgChkRef(TStreamRef aRef);
sl@0: 	};
sl@0: inline TBool operator==(const TAny* aPtr,const TSwizzleCBase& aSwizzle);
sl@0: inline TBool operator!=(const TAny* aPtr,const TSwizzleCBase& aSwizzle);
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Implementation class for swizzles.
sl@0: 
sl@0: Although part of the class hierarchy, no function or data members in this 
sl@0: class form part of the public application programming interface.
sl@0: 
sl@0: The class is not intended for instantiation.
sl@0: 
sl@0: @see TSwizzle  
sl@0: */
sl@0: class TSwizzleBase : public TSwizzleCBase
sl@0: 	{
sl@0: protected:
sl@0: 	TSwizzleBase() {}
sl@0: 	inline TSwizzleBase(TAny* aPtr);
sl@0: 	inline TSwizzleBase(TStreamId anId);
sl@0: 	inline TAny* Ptr() const;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Maintains a dual representation for an object. The representation is:
sl@0: 
sl@0: by stream id, if the object is not in memory (the stream contains the external 
sl@0: representation of that object).
sl@0: 
sl@0: by pointer, if the object is in memory.
sl@0: 
sl@0: The template class defines the type of object for which the swizzle is a representation. 
sl@0: Full access to the represented object is available through the swizzle.
sl@0: 
sl@0: Maintaining a dual representation for an object allows the loading of objects 
sl@0: into memory from a store to be deferred; this is particularly important in 
sl@0: complex applications. 
sl@0: */
sl@0: template <class T>
sl@0: class TSwizzle : public TSwizzleBase
sl@0: 	{
sl@0: public:
sl@0: 	/** Constructs an uninitialised swizzle. It is necessary because there are also 
sl@0: 	non-default constructors in this class. */
sl@0: 	TSwizzle() {}
sl@0: 	inline TSwizzle(T* aPtr);
sl@0: 	inline TSwizzle(TStreamId anId);
sl@0: 	inline TSwizzle<T>& operator=(T* aPtr);
sl@0: 	inline T* AsPtr() const;
sl@0: 	inline operator T*() const;
sl@0: 	inline T& operator*() const;
sl@0: 	inline T* operator->() const;
sl@0: 	inline void ExternalizeL(RWriteStream& aStream) const;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * A specific instantiation of the family of TSwizzle<class T> classes that maintains 
sl@0: the representation of an untyped object as a non-const pointer or as a stream 
sl@0: id.  
sl@0: */
sl@0: TEMPLATE_SPECIALIZATION class TSwizzle<TAny> : public TSwizzleBase
sl@0: 	{
sl@0: public:
sl@0: 	/** Default constructor.
sl@0: 	
sl@0: 	Constructs an uninitialised swizzle. */
sl@0: 	TSwizzle() {}
sl@0: 	inline TSwizzle(TAny* aPtr);
sl@0: 	inline TSwizzle(TStreamId anId);
sl@0: 	inline TSwizzle(const TSwizzleBase& aSwizzle);
sl@0: 	inline TSwizzle<TAny>& operator=(TAny* aPtr);
sl@0: 	inline TSwizzle<TAny>& operator=(const TSwizzleBase& aSwizzle);
sl@0: 	inline TAny* AsPtr() const;
sl@0: 	inline operator TAny*() const;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Maintains a dual representation for a constant object. The representation is:
sl@0: 
sl@0: by stream id, if the object is not in memory (the stream contains the external 
sl@0: representation of that object).
sl@0: 
sl@0: by pointer, if the object is in memory.
sl@0: 
sl@0: The template class defines the type of object for which the swizzle is a representation. 
sl@0: Access to the to the represented object is available through the swizzle, 
sl@0: but is limited. The represented object cannot be changed.
sl@0: 
sl@0: Maintaining a dual representation for an object allows the loading of objects 
sl@0: into memory from a store to be deferred; this is particularly important in 
sl@0: complex applications.  
sl@0: */
sl@0: template <class T>
sl@0: class TSwizzleC : public TSwizzleCBase
sl@0: 	{
sl@0: public:
sl@0: 	/** Constructs an uninitialised swizzle. It is necessary because there are also 
sl@0: 	non-default constructors in this class. */
sl@0: 	TSwizzleC() {}
sl@0: 	inline TSwizzleC(const T* aPtr);
sl@0: 	inline TSwizzleC(TStreamId anId);
sl@0: 	inline TSwizzleC(TSwizzle<T> aSwizzle);
sl@0: 	inline TSwizzleC<T>& operator=(const T* aPtr);
sl@0: 	inline const T* AsPtr() const;
sl@0: 	inline operator const T*() const;
sl@0: 	inline const T& operator*() const;
sl@0: 	inline const T* operator->() const;
sl@0: 	inline void ExternalizeL(RWriteStream& aStream) const;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * A specific instantiation of the family of TSwizzleC<class T> classes that maintains 
sl@0: the representation of an untyped object as a const pointer or as a stream id. 
sl@0: */
sl@0: TEMPLATE_SPECIALIZATION class TSwizzleC<TAny> : public TSwizzleCBase
sl@0: 	{
sl@0: public:
sl@0: 	/** Default constructor.
sl@0: 	
sl@0: 	Constructs an uninitialised swizzle. */
sl@0: 	TSwizzleC() {}
sl@0: 	inline TSwizzleC(const TAny* aPtr);
sl@0: 	inline TSwizzleC(TStreamId anId);
sl@0: 	inline TSwizzleC(const TSwizzleCBase& aSwizzle);
sl@0: 	inline TSwizzleC(TStreamRef aRef);
sl@0: 	inline TSwizzleC<TAny>& operator=(const TAny* aPtr);
sl@0: 	inline TSwizzleC<TAny>& operator=(const TSwizzleCBase& aSwizzle);
sl@0: 	inline const TAny* AsPtr() const;
sl@0: 	inline operator const TAny*() const;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Store map used when externalising swizzled in-memory objects. 
sl@0: 
sl@0: It has three main characteristics:
sl@0: 
sl@0: it acts as an in-memory repository of stream ids and associated swizzles 
sl@0: 
sl@0: it acts as an externaliser for swizzles 
sl@0: 
sl@0: it offers cleanup support  
sl@0: */
sl@0: class CStoreMap : public CBase,public MExternalizer<TStreamRef>
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 	 * @publishedAll 
sl@0: 	 * @released
sl@0: 	 */
sl@0: 	struct TEntry {TSwizzleC<TAny> swizzle;TStreamId id;};
sl@0: 	typedef const TEntry* TIterator;
sl@0: public:
sl@0: 	IMPORT_C static CStoreMap* NewL(CStreamStore& aStore);
sl@0: 	IMPORT_C static CStoreMap* NewLC(CStreamStore& aStore);
sl@0: 	IMPORT_C CStoreMap(CStreamStore& aStore);
sl@0: 	IMPORT_C ~CStoreMap();
sl@0: //
sl@0: 	IMPORT_C void BindL(TSwizzleC<TAny> aSwizzle,TStreamId anId);
sl@0: 	IMPORT_C void Unbind(TSwizzleC<TAny> aSwizzle);
sl@0: 	IMPORT_C void Forget(TStreamId anId);
sl@0: 	IMPORT_C void Reset();
sl@0: 	IMPORT_C void ResetAndDestroy();
sl@0: //
sl@0: 	IMPORT_C TStreamId At(TSwizzleC<TAny> aSwizzle) const;
sl@0: 	IMPORT_C TSwizzleC<TAny> Label(TStreamId anId) const;
sl@0: 	IMPORT_C TIterator Begin() const;
sl@0: 	IMPORT_C TIterator End() const;
sl@0: private:
sl@0: 	void ExternalizeL(const TStreamRef& aRef,RWriteStream& aStream) const;
sl@0: private:
sl@0: 	CArrayFixFlat<TEntry> iArray;
sl@0: 	TStreamId iFree;
sl@0: 	CStreamStore* iStore;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0:  * @publishedAll 
sl@0:  * @released
sl@0:  * Maintains two way associations between a UID (a TUid type) and a stream id 
sl@0: (a TStreamId type) .
sl@0: 
sl@0: Each UID and stream id pair forms an entry in an array. The class provides 
sl@0: member functions to manage these entries, for example, to add a new entry 
sl@0: or to change the stream id associated with a UID.
sl@0: 
sl@0: @see TUid
sl@0: @see TStreamId
sl@0: @see CDictionaryStore 
sl@0:  */
sl@0: class CStreamDictionary : public CBase
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C static CStreamDictionary* NewL();
sl@0: 	IMPORT_C static CStreamDictionary* NewLC();
sl@0: 	IMPORT_C CStreamDictionary();
sl@0: 	IMPORT_C ~CStreamDictionary();
sl@0: //
sl@0: 	IMPORT_C void AssignL(TUid aUid,TStreamId anId);
sl@0: 	IMPORT_C void Remove(TUid aUid);
sl@0: 	IMPORT_C TStreamId At(TUid aUid) const;
sl@0: 	IMPORT_C TBool IsNull() const;
sl@0: 	//
sl@0: 	IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
sl@0: 	IMPORT_C void InternalizeL(RReadStream& aStream);
sl@0: private:
sl@0: 	
sl@0: 	class TEntry
sl@0: 		{
sl@0: 	public:
sl@0: 		TEntry() {}
sl@0: 		inline TEntry(TUid aUid,TStreamId anId);
sl@0: 		void ExternalizeL(RWriteStream& aStream) const;
sl@0: 		void InternalizeL(RReadStream& aStream);
sl@0: 	public:
sl@0: 		TUid iUid;
sl@0: 		TStreamId iId;
sl@0: 		};
sl@0: private:
sl@0: 	CArrayFixSeg<TEntry> iArray;
sl@0: 	};
sl@0: 
sl@0: #include <s32std.inl>
sl@0: #endif