/*

* Copyright (c) 2002 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: 

*     Multiple context manager.

*

*/

#ifndef CWPMULTICONTEXTMANAGER_H

#define CWPMULTICONTEXTMANAGER_H

// INCLUDES

#include <e32base.h>

#include <d32dbms.h>

#include "MWPContextManager.h"

// FORWARD DECLARATIONS

// CONSTANTS

_LIT( KDbTableData, "C" );

_LIT( KDbIndexDataContextId, "CA" );

_LIT( KDbColumnDataContextId, "CB" );

_LIT( KDbColumnDataAdapterId, "CC" );

_LIT( KDbColumnDataSaveData, "CE" );

// CLASS DECLARATION

/**

*  CWPMultiContextManager handles data in contexts.

*

*  @lib ProvisioningEngine

*  @since 2.1

 */ 

class CWPMultiContextManager : public CActive, public MWPContextManager

	{

	public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @return Context manager

        */

		static CWPMultiContextManager* NewL();

        /**

        * Two-phased constructor.

        * @return Context manager

        */

		static CWPMultiContextManager* NewLC();

        /**

        * Destructor.

        */

		~CWPMultiContextManager();

    protected: // From CActive

        void DoCancel();

        void RunL();

	public: // From MWPContextManager

        TUint32 CreateContextL( const TDesC& aName, const TDesC& aTPS, 

            const MDesC16Array& aProxies );

        void DeleteContextL( MWPContextExtensionArray& aArray, TUint32 aUid );

        CArrayFix<TUint32>* ContextUidsL();

        HBufC* ContextNameL( TUint32 aUid );

        HBufC* ContextTPSL( TUint32 aUid );

        CDesC16Array* ContextProxiesL( TUint32 aUid );

        TUint32 ContextL( const TDesC& aTPS );

        TBool ContextExistsL( TUint32 aUid );

        TBool ContextExistsL( const TDesC& aTPS );

        void SaveL( MWPContextExtension& aExtension, TInt aItem );

        TBool DeleteContextDataL( 

            MWPContextExtensionArray& aArray, TUint32 aUid );

        TInt ContextDataCountL( TUint32 aUid );

        TUint32 CurrentContextL();

        void SetCurrentContextL( TUint32 aUid );

        void RegisterContextObserverL( 

            MWPContextObserver* aObserver );

        TInt UnregisterContextObserver( 

            MWPContextObserver* aObserver );

	protected: // New methods

        /**

        * C++ default constructor.

        */

		CWPMultiContextManager();

        /**

        * By default Symbian 2nd phase constructor is private.

        */

		void ConstructL();

        /**

        * Opens the context database.

        */

        void OpenDatabaseL();

        /**

        * Creates the context database.

        */

        void CreateDatabaseL();

        /**

        * Checks the database and performs recovery if needed.

        */

        void CheckDatabaseL();

        /**

        * Creates the names table.

        * @param aDb The database

        */

        void CreateNamesTableL( RDbDatabase& aDb );

        /**

        * Creates the proxies table.

        * @param aDb The database

        */

        void CreateProxiesTableL( RDbDatabase& aDb );

        /**

        * Creates the data table.

        * @param aDb The database

        */

        void CreateDataTableL( RDbDatabase& aDb );

        /**

        * Pushes a database rollback cleanup item and starts a transaction.

        */

        void DatabaseBeginLC();

        /**

        * Pops a database rollback cleanup item and commits a transaction.

        */

        void DatabaseCommitLP();

        /**

        * Cleanup item. Rolls back database transaction.

        * @param aAny The RDbDatabase pointer

        */

        static void CleanupRollback( TAny* aAny );

        /**

        * Pushes a cancel cleanup item on stack.

        * @param aTable The table to cancel on failure

        */

        void InsertBeginLC( RDbTable& aTable ) const;

        /**

        * Puts changes performed on a row.

        * @param aTable The table to change

        */

        void InsertCommitLP( RDbTable& aTable ) const;

        /**

        * Cleanup item. Cancels table update.

        * @param aAny The RDbTable pointer

        */

        static void CleanupCancel( TAny* aAny );

        /**

        * Cleanup item. Deletes the database.

        * @param aAny The RFs pointer

        */

        static void CleanupDeleteDb( TAny* aAny );

        /**

        * Opens a table and puts it on cleanup stack.

        * @param aName Name of the table

        * @param aTable The table object to fill

        * @param aAccess The access type

        */

        void OpenLC( const TDesC& aName, RDbTable& aTable, 

            RDbTable::TAccess aAccess=RDbTable::EUpdatable );

        /**

        * Issues a change notify event to the context database.

        */

        void IssueRequest();

    protected:

        // Database manager

        RDbs                                iDbSession;

        // Database

        RDbNamedDatabase                    iDataBase;

        // The current context

        TUint32                             iCurrentContext;

        // The database change notifier

        RDbNotifier                         iNotifier;

        // The context observers. Observers referred.

        RPointerArray<MWPContextObserver>   iObservers;

        TFileName                           iDataBasePath;

	};

#endif /* CWPMULTICONTEXTMANAGER_H */