/*
 * Copyright (c) 2009 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 file contains the header of CenRep Listener class.
 *
 */

#ifndef TMSCENREPLISTENER_H
#define TMSCENREPLISTENER_H

// INCLUDE FILES
#include <glib.h>
#include <e32base.h>
#include <centralrepository.h>

namespace TMS {

// Forward declarations
class TMSCenRepObserver;

/**
 *   TMSCenRepListener manages getting notification on CenRep key changes.
 */
class TMSCenRepListener : public CActive
    {
public:

    /**
     * Two-phased construction.
     *
     * @param aUid cenrep Uid
     * @param aKey key to be listened
     * @param aObserver observer for key change.
     * @return instance of the class
     */
    static TMSCenRepListener* NewL(TUid aUid, TUint32 aKey,
            TMSCenRepObserver* aObserver);

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

public:

    /**
     * Gets the current value of the monitored setting
     * @param aValue the current value of the monitored setting
     * @return gint Symbian OS error code from central repository
     */
    gint Get(gint& aValue);

    gint Set(gint aValue);

protected:
    // From CActive
    void DoCancel();
    gint RunError(TInt aError);
    void RunL();

private:

    /**
     * Constructor
     * @param aUid cenrep Uid
     * @param aKey key to be listened
     * @param aObserver observer for key change.
     */
    TMSCenRepListener(TUid aUid, TUint32 aKey, TMSCenRepObserver* aObserver);

    /**
     * Private constructing.
     */
    void ConstructL();

    /**
     * Submits a notification request
     */
    void SubmitNotifyRequestL();

private:
    // Owned by this object

    /**
     * UID of CR key.
     */
    TUid iUid;

    /**
     * Repository access.
     * Own.
     */
    CRepository* iRepository;

    /**
     * Identification number of the monitored setting.
     */
    TUint32 iMonitorSetting;

    TMSCenRepObserver* iObserver;
    };

} //namespace TMS

#endif // TMSCENREPLISTENER_H