/*
* 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 __VCX_CONNUTILSUBSCRI_H
#define __VCX_CONNUTILSUBSCRI_H

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

class MConnUtilPubsubObserver;

/**
* This class defines operations listening modifications for the
* property defined.
* Notifies changes throught MConnUtilPubsubObserver interface. 
*
*/ 
NONSHARABLE_CLASS ( CVcxConnUtilSubscriber ) : 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 is supported)
         * @param aObserver pointer to observer to who to notify about changes
         * 
         * @return The newly constructed CVcxConnUtilPubSub
         */
        static CVcxConnUtilSubscriber* NewL( const TUid aUid, 
                                             const TUint32 aKey,
                                             RProperty::TType aType,
                                             MConnUtilPubsubObserver* aObserver );
        
        /**
         * Destructor.
         *
         */
        virtual ~CVcxConnUtilSubscriber();
        
        /**
         * Returns a reference to property this 
         * subscriber listens to.
         * 
         * @return RProperty
         */
        RProperty& Property();
              
        /**
         * Start subscribing if not already started
         */
        void Start();
        
        
    private:  // constuct
        
        /**
         * Constructor
         *
         */
        CVcxConnUtilSubscriber( const TUid aUid, 
                                const TUint32 aKey, 
                                RProperty::TType aType,
                                MConnUtilPubsubObserver* 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
         */
        MConnUtilPubsubObserver* iObserver; 
    };      

#endif // __VCX_CONNUTILSUBSCRI_H