/*
* 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:  
*     This class observes given cenrep value.
*
*/



#ifndef CMMSCENREPOBSERVER_H
#define CMMSCENREPOBSERVER_H

//  INCLUDES
#include    <e32base.h>
#include    <centralrepository.h>
#include    <flogger.h>

// CONSTANTS
// MACROS
// DATA TYPES
// FUNCTION PROTOTYPES
// FORWARD DECLARATIONS
// CLASS DECLARATION

/**
* Interface for requster
*/
class MMmsCenRepNotifyHandler
    {  
    public: // New functions              
        /**
        * Callback for timer cancellation
        * @param aRepositoryUid identifies the repository where the key under
        *   observation is located.
        * @param aKey identifies the particular key under observation.
        * @param aValue specifies the new changed value of the key.
        */               
        virtual void HandleCenRepNotificationL(
            const TUid aRepositoryUid,
            const TInt32 aKey, 
            const TInt aValue ) = 0;
    };

/**
* Class for observing a particular CenRep value
*/
class CMmsCenRepObserver : public CActive
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        * @param aRConnection opened RConnection
        */
        static CMmsCenRepObserver* NewL();

        /**
        * Destructor.
        */
        virtual ~CMmsCenRepObserver();

    public: // New functions

        /**
        * Subscribe to a particular key in CenRep
        * @param aRepositoryUid identifies the repository where the key under
        *   observation is located.
        * @param aKey identifies the particular key under observation.
        * @param aRequester pointer to notification handler
        */
        void SubscribeNotification(
            const TUid aRepositoryUid,
            const TInt32 aKey, 
            MMmsCenRepNotifyHandler* aRequester );

    public: // Functions from base classes

    protected:  // New functions

    protected:  // Functions from base classes

        /**
        * Active object cancellation
        */
        void DoCancel();

    private:

        /**
        * C++ default constructor.
        */
        CMmsCenRepObserver();

        /**
        * By default Symbian OS constructor is private.
        * @param aRConnection opened RConnection
        */
        void ConstructL();

        /**
        * Completion
        */
        void RunL();

        // By default, prohibit copy constructor
        CMmsCenRepObserver( const CMmsCenRepObserver& );

        // Prohibit assignment operator
        CMmsCenRepObserver& operator= ( const CMmsCenRepObserver& );

    private:    // Data

        MMmsCenRepNotifyHandler*   iRequester;
        CRepository*               iRepository;
        TUid                       iRepositoryUid;
        TInt32                     iKey;
    };

#endif      // CMMSCENREPOBSERVER_H

// End of File