/*

* 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:  This is the client side internal file to handle

*                property used in Publish and Subscribe framework.

*

*/

#ifndef __CPSPROPERTYHANDLER_H__

#define __CPSPROPERTYHANDLER_H__

// INCLUDE FILES

// SYSTEM INCLUDES

#include <e32base.h>

#include <e32std.h>

#include <e32debug.h>

#include <e32property.h>

#include <CPcsDefs.h>

// FORWARD declaration

class CPSRequestHandler;

// CLASS DECLARATION

/**

* CPsPropertyHandler

* An instance of the property handler object for the Predicitve Search application

*

* @lib PsServerClientAPI.lib

* @since S60 v3.2

*/

class CPsPropertyHandler : public CActive

{

	public:	// Constructors and destructors

		/**

        * NewL.

        * Two-phased constructor.

        * Creates a CPsPropertyHandler object using two phase construction,

        * and return a pointer to the created object.

        *

        * @param aRequestHandler The object to RequestHandler through

        *                  		 which observers will be called

        * @return A pointer to the created instance of CPsPropertyHandler.

        */	

		static CPsPropertyHandler* NewL( CPSRequestHandler* aRequestHandler );

		/**

        * ~CPsPropertyHandler.

        * Destructor.

        * Destroys the object and release all memory objects.

        */

		~CPsPropertyHandler();

		/**

		* GetCachingStatusL

		* Returns the cache status for synchronous requests

		*/

		TInt GetCachingStatusL(TCachingStatus& aStatus);

	protected: // Functions from base classes

		/**

        * From CActive, RunL.

        * Callback function.

        * Invoked to handle responses from the Algorithm.

        */

		void RunL();

		/**

        * From CActive, DoCancel.

        * Cancels any outstanding operation.

        */

		void DoCancel();

	private: // Constructors and destructors

        /**

        * CPsPropertyHandler.

        * Performs the first phase of two phase construction.

        * @param aObserver The object to be used to

        *                  handle updates from the server.

        */

        CPsPropertyHandler( CPSRequestHandler* aRequestHandler );

        /**

        * ConstructL.

        * Performs the second phase construction of a

        * CPsPropertyHandler object.

        */

        void ConstructL();

    private: // Data

    	/**

    	* iRequestHandler, object to RequestHandler through which 

    	* observers will be accessed

    	*/

		CPSRequestHandler* iRequestHandler;

		/**

		* iProperty, property handle used to attach to the property defined

		*/

		RProperty iCacheStatusProperty;

		/**

		* iCacheErrorProperty, property handle used to attach to the cache error property

		*/

		RProperty iCacheErrorProperty;

};

#endif /* __CPSPROPERTYHANDLER_H__ */

// END OF FILE