/*

* 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_VALIDATE_HANDLER_H

#define WSSTAR_VALIDATE_HANDLER_H

#include <e32std.h>

// FORWARD DECLARATIONS

// CONSTANTS

// INCLUDES

#include <e32std.h>

#include <flogger.h>

#include "sensessionhandler.h"

#include "wsstarhandlercontext.h"

#include "wsstarsessioncontext.h"

#include "SenIdentityProvider.h"

#include "wsstartrustclient.h"

#include "wsstarcons.h"

#include "wsstarservicesession.h"

/**

 * Class:       

 *

 * Description: An implementation of the CWSStarHandler definition. This is concrete

 * class, instance of which ECOM framework gives to ECOM clients.

 */

class CWSStarValidateHandler : 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 CWSStarValidateHandler* 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);

    ~CWSStarValidateHandler();

    virtual SenHandler::THandlerDirection Direction() const;

    virtual SenHandler::THandlerPhase Phase();

    virtual TInt InitL(MSenHandlerContext& aCtx);

    RFileLogger* Log() const;

protected:

    /**

     * Function:   CWSStarValidateHandler

     *

     * Discussion: Perform the first phase of two phase construction

     */

    CWSStarValidateHandler(MSenHandlerContext& aCtx);

    /**

    * Obtain or construct a valid SecurityTokenServiceClient. Ask

    * owned ServiceManager for ServiceDescriptions that match

    * STS contract & ProviderID.

    *

    * @param providerID

    * @return SecurityTokenServiceClient

    */

    CWSStarTrustClient* STSClientL(CSenIdentityProvider*& aIdentityProvider);

    /**

     * Function:   ConstructL

     *

     * Discussion: Perform the second phase construction of a

     *             CImplementationClassPlus object.

     */

    void ConstructL();

private:

    /**

     * Function:   IdentityProviderFromCoreL

     *

     * Discussion: copmplex getter. It asking core for IdentitProvider by using a pattern.

     */

    CSenIdentityProvider* IdentityProviderFromCoreL(const TDesC8& aProviderID);

    const TDesC8* iVersion;

    };

#endif // WSSTAR_VALIDATE_HANDLER_H