diff -r 000000000000 -r 522cd55cc3d7 locationcentre/lcserver/inc/lcregappstore.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/locationcentre/lcserver/inc/lcregappstore.h Tue Feb 02 00:16:03 2010 +0200 @@ -0,0 +1,173 @@ +/* +* Copyright (c) 2007 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: Location Centre Server object. +* +*/ + + +#ifndef C_LCREGAPPSTORE_H +#define C_LCREGAPPSTORE_H + +// SYSTEM INCLUDES +#include +#include +#include // RDbStoreDatabase + +// USER INCLUDES + + +// FORWARD DECLARATIONS +class CFileStore; + +/** + * Implementation of Location Centre private storage info class. + * + * This class provides the implementation of private + * storage of Location Centre Registration info(services) using + * symbian DBMS API. + */ +NONSHARABLE_CLASS( CLcRegAppStore ) : public CBase + { +public: + /** + * Enum to detect wheather Db is created or not + */ + enum TLcDbStatus + { + // Db is successfully created + ELcDbCreate = 0, + // Db is successfully opened + ELcDbOpen + }; + + /** + * Constructs a new instance of CLcRegAppStore. + * + * @return The new instance of CLcRegAppStore object. + * @leave System wide error code if the object creation fails. + */ + static CLcRegAppStore* NewL( RFs& aFs ); + + /** + * Constructs a new instance of CLcRegAppStore. + * Leaves the created instance on the cleanup stack. + * + * @return The new instance of CLcRegAppStore object. + * @leave System wide error code if the object creation fails. + */ + static CLcRegAppStore* NewLC( RFs& aFs ); + + /** + * C++ Destructor. + * Frees all the resources associated with this Location Centre + * server private file handler + */ + virtual ~CLcRegAppStore(); + + +public: + /** + * This function return the first column and first row + * value which is Uuid.After externalize this we extract + * all the seperate Uuid's of dynamically registered services + * + * @since S60 v5.0 + * @param aUuid[ out ] contains the packed Uuid value. + */ + void GetUuidValueL( TDes8& aUuid ); + + /** + * This function insert this packed Uuid value at first column + * and first row of the app info database for first time and then do Update + * + * @since S60 v5.0 + * @param aAppUid[ in ] Packed Uuid value. + * @return + */ + void AddDataToTableL( const TDesC8& aAppUid ); + +private: + /** + * C++ Default constructor + */ + CLcRegAppStore( RFs& aFs ); + + /** + * Second phase of the two phase constructor + */ + void ConstructL(); + +private: // private API for database operations + /** + * Open existing app info database in exclusive + * (non-shared) mode. + * + * @since S60 v5.0 + * @param aRegAppInfoFile is full path to app info + * database file. + */ + void OpenDbL( const TFileName aRegAppInfoFile ); + + /** + * Creates and opens a new app info database. Creates a + * database file, table structure and an index. The database + * will be open in exclusive (non-shareable) mode. The + * database must be closed, when not used any more. If the + * database exists, it is replaced. + * + * @since S60 v5.0 + * @param aRegAppInfoFile is full path to app info + * database file. + */ + void CreateDbL( const TFileName aRegAppInfoFile ); + + /** + * Closes the database opened with either OpenDbL or + * CreateDbL. It is safe to close the database even if it + * is closed. + * + * @since S60 v5.0 + * @param None + * @return None. + */ + void Close(); + + /** + * This function creates the app info table. + * + * @since S60 v5.0 + * @param None + */ + void CreateAppInfoTableL(); + + +private: // Member data + // File server reference comming from the lcregistry + // used for iFileStore + RFs& iFsSession; + + // For database operations + RDbStoreDatabase iRegAppInfoDb; + + //own: For creating and opening database files + CFileStore* iFileStore; + + // holds the database file name + TFileName iLcRegdbFile; + + // holds the db creation status + TLcDbStatus iDbStatus; + }; + +#endif // C_LCREGAPPSTORE_H \ No newline at end of file