/*
* 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:    Header declaration
*
*/











#ifndef WSSTAR_POLICY_HANDLER_H
#define WSSTAR_POLICY_HANDLER_H

// INCLUDES
#include <e32std.h>
#include <flogger.h>
#include "sensessionhandler.h"
#include "wsstarhandlercontext.h"
#include "wsstarsessioncontext.h"
#include "wsstartrustclient.h"
#include "wsstarcons.h"
#include "wsstarservicesession.h"
#include "wspolicyregistry.h"

class CWSStarDictionary;
class CWSStarPolicyManager;

/**
 * Class:       
 *
 * Description: An implementation of the CWSStarHandler definition. This is concrete
 * class, instance of which ECOM framework gives to ECOM clients.
 */
class CWSStarPolicyHandler : public CSenSessionHandler
    {

    public:


       /**
        * Function:    NewL
        *
        * Description: Create instance of concrete implementation. Note that ECOM
        *              interface implementations can only have two signatures for
        *              NewL:
        *               - NewL without parameters (used here)
        *               - NewL with TAny* pointer, which may provide some client
        *                 data
        *
        * Returns:    Instance of this class.
        *
        * Note:       The interface, which is abstract base class of this
        *             implementation, also provides NewL method. Normally abstract
        *             classes do not provide NewL, because they cannot create
        *             instances of themselves.
        */
        static CWSStarPolicyHandler* NewL(TAny* aHandlerCtx);

        /**
        * InvokeL is the most emergent method in message handler interface.
        * Each sub-class must implement this method thus providing message
        * processing routine.
        * @param aCtx is the session context that will be accessed and 
        * typically altered by implemented handler, in order to provide
        * modifications on the layer of the session construction, validation,
        * or some other, focused area that the handler was intended to take
        * responsibility for. For example, certain handler can itself create
        * a session of its own, send message(s) to (authentication) service
        * (invoking other handlers), and finally access session context in 
        * order to update credentials. One example of such session handler
        * could be WS-TRUST client type handler, an "internal service consumer".
        */
        virtual TInt InvokeL(MSenSessionContext& aCtx);
        
        ~CWSStarPolicyHandler();
        virtual SenHandler::THandlerDirection Direction() const;
        virtual SenHandler::THandlerPhase Phase();
        virtual TInt InitL(MSenHandlerContext& aCtx);
        CSenElement* PolicyL(MSenServiceDescription* aSD);	//codescannerwarnings
        CSenElement* PolicyL(const TDesC8& aUri);	//codescannerwarnings
        TInt InvokeL(const TDesC8& aContract);
        TInt DownloadPolicyL(CSenWSDescription* apArgument);
        TInt UpdatePolicyL();
        TInt UnRegisterWsPolicyL(MSenServiceDescription& aServiceDescription);        
        TInt PolicyConsumerAddedL(CSenServiceSession* aNewSession, MSenRemoteServiceConsumer& aRemoteConsumer);
        RFileLogger* Log() const;
        void DataTrafficDetails(TSenDataTrafficDetails& aDetails); 		      
            
    protected:
        /**
         * Function:   CWSStarPolicyHandler
         *
         * Discussion: Perform the first phase of two phase construction
         */
        CWSStarPolicyHandler(MSenHandlerContext& aCtx);
        
        /**
         * Function:   ConstructL
         *
         * Discussion: Perform the second phase construction of a
         *             CImplementationClassPlus object.
         */
        void ConstructL();
        
    private: // Data
        CWSStarPolicyManager* iPolicyManager;
        
    };
#endif // WSSTAR_POLICY_HANDLER_H