/*
* Copyright (c) 2006-2006 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:  CPSStateMapper class declaration.
*
*/



#ifndef C_PSSTATEMAPPER_H
#define C_PSSTATEMAPPER_H

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


class MCFContextInterface;

/**
* P&S state mapper wraps inside a selected P&S key from some category
* and maps this key to defined context.
* Currently only integer P&S values are handled. If other P&S values
* are wanted to map into contexts derive this class and provide support
* for this.
* 
* @lib -
* @since S60 4.0
*/
NONSHARABLE_CLASS( CPSStateMapper ): public CActive
    {
    public:
    
        // Mapper ids
        enum TPSStateMapperType
            {
            EPSIntMapper,
            EPSTextMapper
            };
    
    public:
            
        // Destructor
        ~CPSStateMapper();
        
    public: // New methods
    
    	virtual TInt MapperType() const = 0;
    
    	void SetPSCategory (TUid aPSCategory);
    	void SetPSKey (TUint32 aKey);
    	void SetSecurityPolicy (const TSecurityPolicy& aSecurityPolicy);
    	void SetSourceL ( const TDesC& aSource );
    	void SetTypeL ( const TDesC& aType );
    	void SetPassThrough(TBool aPassThrough);
    
        /**
        * Returns context source related to this mapping.
        * 
        * @since S60 4.0
        * @param None
        * @return const TDesC&
        */
        virtual const TDesC& Source() const;
        
        /**
        * Returns context type related to this mapping.
        * 
        * @since S60 4.0
        * @param None
        * @return const TDesC&
        */
        virtual const TDesC& Type() const;

        /**
        * Returns security policy related to this mapping.
        * 
        * @since S60 4.0
        * @param None
        * @return const TSecurityPolicy&
        */
        virtual const TSecurityPolicy& SecurityPolicy() const;
        
        virtual void Define() = 0;
        virtual void InitializeL() = 0;

    protected: // New methods
    
        /**
        * Subscribes into property.
        * 
        * @since S60 4.0
        * @param None
        * @return None
        */
        virtual void Subscribe();
    
    protected: // From base classes
    
        // @see CActive
        virtual void RunL();
    
        // @see CActive
        virtual void DoCancel();

        // @see CActive
        virtual TInt RunError( TInt aError );
        
    private: // New methods
    
        // Informs implementation that propery has changed
        virtual void ProperyChangedL() = 0;

    protected:
    
        CPSStateMapper( MCFContextInterface& aCF );
        virtual void ConstructL( );
        
    protected: // Data
    
        // Own: P&S property in hand.
        RProperty iProperty;
        
        
	public:
    
        // P&S category
        TUid iPSCategory;
        
        // P&S key from iPSCategory
        TUint32 iPSKey;

        // Context source to publish
        HBufC* iSource;
        
        // Context type to publish
        HBufC* iType;
        
        // Security policy
        TSecurityPolicy iSecurityPolicy;

		TBool iPassThrough;
        
        // CF interface
        MCFContextInterface& iCF;
        
        CCFContextObject* iContext;
        
    };

#endif