/*

* Copyright (c) 2004 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:  Shared data handler for IMPSCommonUI

*

*/

#ifndef __CWVSETTINGSUISHAREDDATAHANDLER_H

#define __CWVSETTINGSUISHAREDDATAHANDLER_H

//  INCLUDES

#include "MIMPSSharedData.h"

#include "IMPSSharedDataDefs.h"

#include <e32base.h>

#include <SharedDataClient.h>

// FORWARD DECLARATIONS

class MIMPSSharedDataObserver;

// CLASS DECLARATION

/**

*  Shared data handler

*

*  @lib WVServiceSettingsUi.dll

*  @since 2.6

*/

NONSHARABLE_CLASS( CIMPSSharedDataHandler ) : public CBase,

        public MIMPSSharedData,

        public MSharedDataNotifyHandler

    {

public: // New functions

    /**

    * Two-phased constructor.

    * @param aResourceId the resource of the setting page

    * @param aSelectionItemList the selection item list of the setting page

    */

    static CIMPSSharedDataHandler* NewL( MIMPSSharedDataObserver* aObserver,

    const TUid aUid,

    TBool aTemporary = EFalse );

private: // constructor and destructor

    /**

    * C++ default constructor.

    */

    CIMPSSharedDataHandler( MIMPSSharedDataObserver* aObserver,

                            const TUid aUid,

                            TBool aTemporary );

    /**

     * Symbian OS constructor.

     */

    void ConstructL();

    /**

    * Destructor.

    */

    virtual ~CIMPSSharedDataHandler();

private: //Functions from base classes

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt SubscribeChange( const TUid aUid, const TIMPSSharedKeys aKey );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt SubscribeSet( const TUid aUid, const TIMPSSharedKeys aKey );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    void UnSubscribe( const TUid aUid, const TIMPSSharedKeys aKey );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt GetStringKey( const TIMPSSharedKeys aKey, TDes& aValue );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt GetIntKey( const TIMPSSharedKeys aKey, TInt& aValue );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt SetStringKey( const TIMPSSharedKeys aKey, const TDesC& aValue );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt SetIntKey( const TIMPSSharedKeys aKey, TInt aValue );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt Signal( const TIMPSSharedKeys aKey );

    /**

    * From MIMPSSharedData

    * @see MIMPSSharedData

    */

    TInt CancelSignal( const TIMPSSharedKeys aKey );

    /**

    * From MSharedDataNotifyHandler

    * @param aUid uid of the dll

    * @param aKey the shared data key

    * @param aValue the value of the key

    */

    void HandleNotifyL( const TUid aUid,

                        const TDesC& aKey,

                        const TDesC& aValue );

    /**

    * From MSharedDataNotifyHandler

    * Converts shared data keys to TIMPSSharedKeys

    * @param aKey keyword

    * @return error code

    */

    TInt ConvertSharedDataKey( const TDesC& aSrc, TIMPSSharedKeys& aDest );

private: // new functions

    /**

    * Does the actual setting of the key

    * @see MIMPSSharedData

    */

    void DoSetIntKeyL( const TIMPSSharedKeys aKey, TInt aValue );

    /**

    * Converts the TIMPSSharedKeys to shared data keys

    * @param aKey the key from the enumeration that clients use

    * @param aSharedDataKey the shared data key

    * @return KErrNone if found, KErrNotFound if not found

    */

    TInt MapKeysToSharedData( const TIMPSSharedKeys aKey, TDes& aSharedDataKey );

    /**

    * Converts the shared data keys to TIMPSSharedKeys

    * @param aKey the key from the enumeration that clients use

    * @param aSharedDataKey the shared data key

    * @return KErrNone if found, KErrNotFound if not found

    */

    TInt MapKeysToClient( TIMPSSharedKeys& aKey, const TDesC& aSharedDataKey );

    /**

    * Creates the array of key mappings

    */

    void AppendKeyPairsL( );

    /**

    * Appends a key pair into the array of keys

    * @param aKey the key from the enumeration that clients use

    * @param aSharedDataKey the shared data key

    */

    void DoAppendKeyPairL( TIMPSSharedKeys aKey, const TDesC& aSharedDataKey );

    /**

    * Does the actual signalling

    * @param aKey the key to signal

    */

    void DoSignalL( const TIMPSSharedKeys aKey );

    /**

    * Does the actual cancelling

    * @param aKey the key to signal

    */

    void DoCancelSignalL( const TIMPSSharedKeys aKey );

private:    // Data

    // Doesn't own: observer for the shared data.

    MIMPSSharedDataObserver* iObserver;

    ///Shared data client to read common settings, owned

    RSharedDataClient    iSharedDataClient;

    // identifier of the ini file we are interested in

    TUid iUid;

    //Array of key pairs

    RArray<TIMPSSharedKeyPairs> iKeys;

    // tells if we should use temporary keys

    TBool iTemporary;

    };

#endif      // __CWVSETTINGSUISHAREDDATAHANDLER_H

// End of File