/*

* 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 <e32base.h>

#include <f32file.h>

#include <d32dbms.h>    // 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