/*
* 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:  Central Repository key observer
 *
*/


#ifndef __LOCKAPPCENREPOBSERVER_H__
#define __LOCKAPPCENREPOBSERVER_H__

// INCLUDES
#include <e32std.h>
#include <cenrepnotifyhandler.h>
#include "lockappobserverinterface.h"

/**
 *  CLockAppCenRepObserver class is a Central Repository key observer
 *  which can be used to monitor and set a CenRep value.
 *
 *  @lib    lockapp
 *  @since  5.0
 *  @author Tamas Koteles
 */
class CLockAppCenRepObserver : public CBase, public MCenRepNotifyHandlerCallback
	{
	public:

		/**
		 * Two-phased constructor.
		 *
		 * @param aObserver   pointer to observer
		 * @param aCenRepUid  repository Uid
		 * @param aKeyId      repository key Id
		 * @return            the instance just created
		 */
		static CLockAppCenRepObserver* NewL( MLockAppObserverInterface* aObserver, TUid aCenRepUid,
				TUint32 aKeyId );

		/**
		 * Destructor.
		 */
		~CLockAppCenRepObserver( );

		/**
		 * Get key value from CenRep.
		 */
		TInt GetValue( TInt& aValue );

		/**
		 * Get the value from a different CenRep key.
		 */
		TInt GetKeyValue( TUint32 aKey, TInt& aValue );

		/**
		 * Set key value to CenRep.
		 */
		TInt SetValue( TInt aValue );

		/**
		 * Set the value of a different CenRep key.
		 */
		TInt SetKeyValue( TUint32 aKey, TInt aValue );

	public:

		/**
		 * From MCenRepNotifyHandlerCallback. Handles change event. Called by CenRep.
		 *
		 * @param aId the id of the changed setting
		 * @param aNewValue the new value of the changed setting
		 */
		void HandleNotifyInt( TUint32 aId, TInt aNewValue );

		void HandleNotifyError( TUint32 aId, TInt error, CCenRepNotifyHandler* aHandler );

		void HandleNotifyGeneric( TUint32 aId );

	protected:

		/**
		 * C++ default constructor.
		 *
		 * @param aObserver  pointer to observer
		 * @param aCenRepUid central repository Uid
		 * @param aKeyId     key Id
		 */
		CLockAppCenRepObserver( MLockAppObserverInterface* aObserver, TUid aCenRepUid,
				TUint32 aKeyId );

		/**
		 * Symbian OS constructor.
		 */
		void ConstructL( );

	protected:

		/**
		 * Observer's callback interface. Not owned.
		 */
		MLockAppObserverInterface* iObserver;

		/**
		 * CenRep value notifier.
		 */
		CCenRepNotifyHandler* iNotifyHandler;

		/**
		 * Access to central repository.
		 */
		CRepository* iRepository;

		/**
		 * Repository Uid.
		 */
		TUid iCenRepUid;

		/**
		 * Repository key Id.
		 */
		TUint32 iKeyId;

	};

#endif // __LOCKAPPCENREPOBSERVER_H__
// END OF FILE