/*
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:    Class to handle subscribtions from PS*
*/




#ifndef __VCXNS_CONTENTHARVERSTERPSSUBSCRI_H
#define __VCXNS_CONTENTHARVERSTERPSSUBSCRI_H

#include <e32base.h>	
#include <e32property.h>

NONSHARABLE_CLASS ( MCHPSObserver )
    {
    public:
        virtual void ValueChanged( const TUint32& aKey, const TInt& aValue ) = 0;  
    
    };

 
NONSHARABLE_CLASS ( CVcxNsCHPSSubscriber ) : public CActive
    {

    public: // constuct / destruct
    
        /**
         * Construction.
         * 
         * @param aUid      category for the property
         * @param aKey      key id for the property
         * @param aType     type of the key (at the moment only int -type is supported)
         * @param aObserver observer to who to notify about changes
         * 
         * @return The newly constructed CVcxConnUtilPubSub
         */
        static CVcxNsCHPSSubscriber* NewL( const TUid aUid, 
                                           const TUint32 aKey,
                                           RProperty::TType aType,
                                           MCHPSObserver* aObserver );
        
        /**
         * Destructor.
         *
         */
        virtual ~CVcxNsCHPSSubscriber();
        
        /**
         * Returns a pubsub value from this property
         * 
         *@param &aValue value to fetch
         * 
         *@return TInt KErrNone or some system level error code
         */
        TInt Get( TInt& aValue );
            
        /**
         * Start subscribing if not already started
         */
        void Start();
        
        
    private:  // constuct / destruct
        
        /**
         * Constructor
         *
         */
        CVcxNsCHPSSubscriber( const TUid aUid, 
                              const TUint32 aKey, 
                              RProperty::TType aType, 
                              MCHPSObserver* aObserver );
        
        /**
         * Symbian 2nd phase construction
         *   
         */
        void ConstructL();
     
    private: // from CActive
        
        /**
         * From CActive. Calles when value subscribed to changes 
         * 
         */  
        void RunL();
        
        /**
         * From CActive. Cancels subscribtion
         * 
         */
        void DoCancel();
        
    private:
        
        /**
         * ETrue if object is initialized and subscribtion starts
         */
        TBool            iInitialized;
        
        /**
         * Property to subscribe
         */
        RProperty        iProperty;
        
        /**
         * Category uid for the property
         */
        const TUid       iUid;
        
        /**
         * Key id for the property
         */
        const TUint32    iKey;
        
        /**
         * type of the property
         */
        RProperty::TType iKeyType;
        
        /**
         * observer, not owned
         */
        MCHPSObserver*   iObserver;

    };      

#endif // __VCXNS_CONTENTHARVERSTERPSSUBSCRI_H