1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/persistentdata/persistentstorage/sql/SRC/Server/SqlSrvObjContainer.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,83 @@
     1.4 +// Copyright (c) 2006-2010 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +//
    1.18 +
    1.19 +#ifndef __SQLSRVOBJCONTAINER_H__
    1.20 +#define __SQLSRVOBJCONTAINER_H__
    1.21 +
    1.22 +#include <e32std.h>
    1.23 +#include "SqlAssert.h"
    1.24 +
    1.25 +/**
    1.26 +Indexed storage for server sdide objects.
    1.27 +
    1.28 +RDbObjContainer container is used for storing IPC stream handles (HIpcStream) and 
    1.29 +statement handles (CSqlSrvStatement).
    1.30 +
    1.31 +Behaviour when the container is destroyed:
    1.32 + - all objects inside the container are destroyed too;
    1.33 + 
    1.34 +Behaviour when the an object is removed from the container:
    1.35 + - the container will destroy the object;
    1.36 +
    1.37 +Behaviour when the an object is added to the container:
    1.38 + - the container stores the object <by_ref>, not <by_val>;
    1.39 +
    1.40 +Behaviour when a look up is performed in the container for an object:
    1.41 + - a pointer to the object is returned or NULL if there is no object;
    1.42 +
    1.43 +@see CSqlSrvStatement
    1.44 +@see HIpcStream
    1.45 +@see RDbObjContainer::Close()
    1.46 +@see RDbObjContainer::AllocL()
    1.47 +@see RDbObjContainer::Add()
    1.48 +@see RDbObjContainer::Remove()
    1.49 +@see RDbObjContainer::Find()
    1.50 +@see RDbObjContainer::Count()
    1.51 +
    1.52 +@internalComponent
    1.53 +*/
    1.54 +template <class T> class RDbObjContainer
    1.55 +	{
    1.56 +public:
    1.57 +	RDbObjContainer();
    1.58 +	void Close();
    1.59 +	void AllocL();
    1.60 +	TInt Add(T* aObj);
    1.61 +	void Remove(TInt aHandle);
    1.62 +	T* Find(TInt aHandle) const;
    1.63 +	TInt Count() const;
    1.64 +
    1.65 +private:	
    1.66 +	TInt MakeHandle(TInt aIndex) const;
    1.67 +	TInt MakeIndex(TInt aHandle) const;
    1.68 +	
    1.69 +private:	
    1.70 +	struct TEntry
    1.71 +		{
    1.72 +		T*		iObj;
    1.73 +		TInt	iNext;
    1.74 +		};
    1.75 +	enum {KGranularity = 16};
    1.76 +	//KMaxSize value depends on how many bits are used for handles - see
    1.77 +	//KStmtHandleMask and KStreamHandleMask in SqlUtil.h file.
    1.78 +	enum {KMaxSize = 0x7FF};
    1.79 +	TEntry*	iEntries;
    1.80 +	TInt	iSize;
    1.81 +	TInt 	iFree;
    1.82 +	};
    1.83 +
    1.84 +#include "SqlSrvObjContainer.inl"
    1.85 +
    1.86 +#endif//__SQLSRVOBJCONTAINER_H__