webservices/wsstar/wsstarplugin/inc/wsstarvalidatehandler.h
changeset 0 62f9d29f7211
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/webservices/wsstar/wsstarplugin/inc/wsstarvalidatehandler.h	Thu Jan 07 16:19:19 2010 +0200
@@ -0,0 +1,139 @@
+/*
+* 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
+