1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/persistentdata/persistentstorage/sql/SRC/Server/SqlSrvObjContainer.inl Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,197 @@
1.4 +// Copyright (c) 2008-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 +// SqlSvrObjContainer.inl
1.18 +// Should not be a template class!
1.19 +// Constructs an empty container.
1.20 +//
1.21 +//
1.22 +
1.23 +template <class T>
1.24 +RDbObjContainer<T>::RDbObjContainer() :
1.25 + iEntries(NULL),
1.26 + iSize(0),
1.27 + iFree(0)
1.28 + {
1.29 + }
1.30 +
1.31 +/**
1.32 +Destroys the container and its content.
1.33 +*/
1.34 +template <class T>
1.35 +void RDbObjContainer<T>::Close()
1.36 + {
1.37 + if(iEntries)
1.38 + {
1.39 + for(/*RDbObjContainer<T>::*/TEntry* entry=iEntries;entry<(iEntries+iSize);++entry)
1.40 + {
1.41 + delete entry->iObj;
1.42 + }
1.43 + User::Free(iEntries);
1.44 + iEntries = NULL;
1.45 + }
1.46 + iFree = iSize = 0;
1.47 + }
1.48 +
1.49 +/**
1.50 +Ensures that the next attempt for adding a new object to the container won't fail because there
1.51 +is no memory.
1.52 +(In other words - ensures that the container has at least one empty slot)
1.53 +
1.54 +@leave KErrNoMemory, an out of memory condition has occured;
1.55 +
1.56 +@panic SqlDb 7 In _DEBUG mode. Internal logic error.
1.57 +*/
1.58 +template <class T>
1.59 +void RDbObjContainer<T>::AllocL()
1.60 + {
1.61 + __ASSERT_DEBUG(iFree <= iSize, __SQLPANIC(ESqlPanicInternalError));
1.62 + if(iFree == iSize)
1.63 + {
1.64 + if(iSize >= KMaxSize)
1.65 + {
1.66 + __SQLLEAVE(KErrNoMemory);
1.67 + }
1.68 + TInt size = iSize + RDbObjContainer<T>::KGranularity;
1.69 + iEntries = (TEntry*)User::ReAllocL(iEntries, size * sizeof(TEntry));
1.70 + iSize = size;
1.71 + for(TInt i=iFree;i<size;)
1.72 + {
1.73 + /*RDbObjContainer<T>::*/TEntry& entry = iEntries[i];
1.74 + entry.iObj = NULL;
1.75 + entry.iNext = ++i;
1.76 + }
1.77 + }
1.78 + }
1.79 +
1.80 +/**
1.81 +The method adds "aObj" pointer to the container.
1.82 +
1.83 +@param aObj A pointer to the object which will be stored in the container.
1.84 +
1.85 +@return Handle, uniquely identifying the stored object
1.86 +
1.87 +@panic SqlDb 4 In _DEBUG mode. aObj parameter is NULL.
1.88 +@panic SqlDb 7 In _DEBUG mode. Internal logic error.
1.89 +*/
1.90 +template <class T>
1.91 +TInt RDbObjContainer<T>::Add(T* aObj)
1.92 + {
1.93 + __ASSERT_DEBUG(aObj != NULL, __SQLPANIC(ESqlPanicBadArgument));
1.94 + __ASSERT_DEBUG(iFree <= iSize, __SQLPANIC(ESqlPanicInternalError));
1.95 + TInt idx = iFree;
1.96 + if(idx < iSize)
1.97 + {
1.98 + /*RDbObjContainer<T>::*/TEntry& entry = iEntries[idx];
1.99 + __ASSERT_DEBUG(!entry.iObj, __SQLPANIC(ESqlPanicInternalError));
1.100 + iFree = entry.iNext;
1.101 + __ASSERT_DEBUG(iFree <= iSize, __SQLPANIC(ESqlPanicInternalError));
1.102 + entry.iObj = aObj;
1.103 + return MakeHandle(idx);
1.104 + }
1.105 + return 0;
1.106 + }
1.107 +
1.108 +/**
1.109 +@param aIndex Valid container index.
1.110 +
1.111 +@return Handle, uniquely identifying the object stored at aIndex index.
1.112 +*/
1.113 +template <class T>
1.114 +TInt RDbObjContainer<T>::MakeHandle(TInt aIndex) const
1.115 + {
1.116 + return aIndex + 1;
1.117 + }
1.118 +
1.119 +/**
1.120 +@param aHandle Unique object handle
1.121 +
1.122 +@return Container index of the object, identified by aHandle parameter.
1.123 +*/
1.124 +template <class T>
1.125 +TInt RDbObjContainer<T>::MakeIndex(TInt aHandle) const
1.126 + {
1.127 + return aHandle - 1;
1.128 + }
1.129 +
1.130 +/**
1.131 +Removes an object from the container.
1.132 +The removed object will be destroyed.
1.133 +
1.134 +@param aHandle Unique object handle
1.135 +
1.136 +@panic SqlDb 7 In _DEBUG mode. Internal logic error or there is no such object in the container.
1.137 +*/
1.138 +template <class T>
1.139 +void RDbObjContainer<T>::Remove(TInt aHandle)
1.140 + {
1.141 + __ASSERT_DEBUG(iFree <= iSize, __SQLPANIC(ESqlPanicInternalError));
1.142 + if(aHandle > 0) //It is a handle, sent by the client. It isn't a server's problem if the handle is <= 0.
1.143 + {
1.144 + TInt idx = MakeIndex(aHandle);
1.145 + if(idx < iSize)
1.146 + {
1.147 + /*RDbObjContainer<T>::*/TEntry& entry = iEntries[idx];
1.148 + delete entry.iObj;
1.149 + entry.iObj = NULL;
1.150 + entry.iNext = iFree;
1.151 + iFree = idx;
1.152 + }
1.153 + }
1.154 + __ASSERT_DEBUG(iFree <= iSize, __SQLPANIC(ESqlPanicInternalError));
1.155 + }
1.156 +
1.157 +/**
1.158 +Looks up for an object in the container.
1.159 +
1.160 +@param aHandle Unique object handle
1.161 +
1.162 +@return A pointer to the found object or NULL.
1.163 +*/
1.164 +template <class T>
1.165 +T* RDbObjContainer<T>::Find(TInt aHandle) const
1.166 + {
1.167 + /*RDbObjContainer<T>::*/TEntry* entry = NULL;
1.168 + if(aHandle > 0) //It is a handle, sent by the client. It isn't a server's problem if the handle is <= 0.
1.169 + {
1.170 + TInt idx = MakeIndex(aHandle);
1.171 + if(idx < iSize)
1.172 + {
1.173 + entry = &iEntries[idx];
1.174 + }
1.175 + }
1.176 + return entry != NULL ? entry->iObj : NULL;
1.177 + }
1.178 +
1.179 +/**
1.180 +Counts the alive objects in the container
1.181 +
1.182 +@return The object count
1.183 +*/
1.184 +template <class T>
1.185 +TInt RDbObjContainer<T>::Count() const
1.186 + {
1.187 + TInt count = 0;;
1.188 + const /*RDbObjContainer::*/TEntry* const base = iEntries;
1.189 + if(base)
1.190 + {
1.191 + for(const /*RDbObjContainer::*/TEntry* e=base+iSize;--e>=base;)
1.192 + {
1.193 + if(e->iObj)
1.194 + {
1.195 + ++count;
1.196 + }
1.197 + }
1.198 + }
1.199 + return count;
1.200 + }