// Copyright (c) 2001-2009 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:
//

/**
 @file CWspTransportHandler.h
 @warning : This file contains Rose Model ID comments - please do not delete
*/

#ifndef __CWSPTRANSPORTHANDLER_H__
#define __CWSPTRANSPORTHANDLER_H__

// System includes
#include <e32base.h>
#include <stringpool.h>
#include <http/framework/csecuritypolicy.h>

// Forward class declarations
class MWspCOSessionCallback;
class MWspProxyInfoProvider;
class MWspCapabilityProvider;
class MWspSessionHeadersProvider;
class MWspCOSessionInvoker;
class MWspCOMethodInvoker;
class MWspCOPushInvoker;
class MWspCLMethodInvoker;
class MWspCLPushInvoker;


//##ModelId=3BBD849A0269
class CWspTransportHandler : public CBase, public MSecurityPolicy
/** 
@since			7.0
The WSP Transport Handler API. The WSP TH provides its client with WSP services.
It defines a set of interfaces that abstract the behaviour of the top-level of a
WAP protocol stack - ie. the WSP layer.

Five distinct services are offered:

* MWspCOSessionInvoker a Connection-Oriented Session service.

* MWspCOMethodInvoker a Connection-Oriented Transaction service.

* MWspCOPushInvoker a Connection-Oriented Push service.

* MWspCLMethodInvoker a Connection-Less Session service.

* MWspCLPushInvoker a Connection-Less Push service.

The API is specified as an ECOM interface.  Specific implementations may offer
some or all of the five services.

All implementations must provide default security policy settings via the
MSecurityPolicy interface.  The defaults shall be used when no security policy
plug-in is supplied by the caller of CWspTransportHandler::NewL().  This might
occur if the plug-in could not be located on the device,
@publishedAll
@deprecated
*/
	{
public: // type definitions and enumerations

/** A bit-field type that is set to contain a union of the services supported by the
	WSP transport handler.
*/
	typedef TUint8 TWspSupportedServices;

/** The five different service types that may be supported
*/
	enum TWspService
		{
		ECOSessionService = 0x01,
		ECOMethodInvocationService = 0x02,
		ECOPushService = 0x04,
		ECLSessionService = 0x08,
		ECLPushService = 0x10
		};

public: // methods

/**Factory construction - instantiates the transport handler plug-in.
	@since			7.0
	@param			aStringPool		(in) An open string pool reference.
	@param			aSecurityPolicy	(in) (optional) A security policy provider
	@param			aSessionCB		(in) A client callback API for CO session events.
	@param			aProxyInfoProv	(in) A client API that provides WAP proxy details
	@param			aCapProv		(in) A client API for capability negotatiation.
	@param			aSessHdrProv	(in) A client API for exchange of session headers
	@return			The constructed plug-in.
	@leave		KErrNotFound - if an ECOM implementation of the interface is not present on the device.
	@leave		It could also leave with other ECOM error codes.
*/
	//##ModelId=3C4C453103DD
	inline static CWspTransportHandler* NewL(RStringPool aStringPool,
											   MSecurityPolicy* aSecurityPolicy,
											   MWspCOSessionCallback& aSessionCB,
											   MWspProxyInfoProvider& aProxyInfoProv,
											   MWspCapabilityProvider& aCapProv,
											   MWspSessionHeadersProvider& aSessHdrProv);

/**Class destructor.
	@since			7.0
*/
	//##ModelId=3C4C453103AB
	inline virtual ~CWspTransportHandler();

public: // General API methods

/**Query the services supported by this instantiation of the WSP
					transport handler plug-in.
	@since			7.0
	@return			A union of flags describing the services supported by the WSP transport
					handler
*/
	//##ModelId=3C4C45310256
	virtual TWspSupportedServices SupportedServices() const = 0;

	/** Get the Server Certificate for the current session.
	@param	aServerCert A TCertInfo which will be filled with the certificate information
	@return	An error code.  KErrNone if aServerCert has been completed, otherwise one of 
			the system wide error codes
	*/
	virtual TInt ServerCert(TCertInfo& aCertInfo) const = 0;

	/** Get the Server Certificate for this session.
	@return	The certificate information  (in an CWtlsCertificate object) 
			or NULL if it is not available.
	*/
	virtual const CCertificate* ServerCert() = 0;

public: // Connection-Oriented WSP API methods

/**Obtain the connection-oriented session invocation API.
	@since			7.0
	@return			The API object that should be used by the client for CO session
					invocations.
	@leave		This method will panic if the service isn't supported by a particular
					implementation of the API.
*/
	//##ModelId=3BC577C202B2
	virtual MWspCOSessionInvoker& COSessionInvoker() = 0;

/**Obtain the connection-oriented transaction invocation API.
	@since			7.0
	@return			The API object that should be used by the client for transaction
					invocations.
	@leave		This method will panic if the service isn't supported by a particular
					implementation of the API.
*/
	//##ModelId=3BC577C70165
	virtual MWspCOMethodInvoker& COTransactionInvoker() = 0;

/**Obtain the connection-oriented push invocation API.
	@since			7.0
	@return			The API object that should be used by the client to signal
					readiness to receive CO push invocations.
	@leave		This method will panic if the service isn't supported by a particular
					implementation of the API.
*/
	//##ModelId=3C4C45310206
	virtual MWspCOPushInvoker& COPushInvoker() = 0;

public: // Connection-Less WSP API methods

/**Obtain the connection-less method invocation API.
	@since			7.0
	@return			The API object that should be used by the client for CL method
					invocations.
	@leave		This method will panic if the service isn't supported by a particular
					implementation of the API.
*/
	//##ModelId=3C4C453101DE
	virtual MWspCLMethodInvoker& CLMethodInvoker() = 0;

/**Obtain the connection-less push invocation API.
	@since			7.0
	@return			The API object that should be used by the client to signal
					readiness to receive CL push invocations.
	@leave		This method will panic if the service isn't supported by a particular
					implementation of the API.
*/
	//##ModelId=3C4C453101CA
	virtual MWspCLPushInvoker& CLPushInvoker() = 0;

protected: // type definitions
	/** 
		@struct SInstantiationParams
		A structure containing the instantiation parameters to NewL, passed across
		via ECOM to the sub-class NewL
	*/
	struct SInstantiationParams
		{
		/**
			An open string pool reference.
		*/
		RStringPool* iStringPool;
		/**
			The security policy plugin. 
		*/
		MSecurityPolicy* iSecurityPolicy;
		/**
			A client callback API for CO session events.
		*/
		MWspCOSessionCallback* iSessionCB;
		/**
			A client API that provides WAP proxy details.
		*/
		MWspProxyInfoProvider* iProxyInfoProv;
		/**
			A client API for capability negotatiation. 
		*/
		MWspCapabilityProvider* iCapProv;
		/** 
			A client API for exchange of session headers. 
		*/
		MWspSessionHeadersProvider* iSessHdrProv;
		};

protected: // methods

/**Normal constructor. Creates an instance of the plug-in base.
	@since			7.0
	@param			aStringPool		(in) An open string pool reference.
	@param			aSecurityPolicy	(in) (optional) A security policy plug-in instance
	@param			aSessionCB		(in) A client callback API for CO session events.
	@param			aProxyInfoProv	(in) A client API that provides WAP proxy details
	@param			aCapProv		(in) A client API for capability negotatiation.
	@param			aSessHdrProv	(in) A client API for exchange of session headers
	@return			The constructed plug-in.
*/
	inline CWspTransportHandler(RStringPool aStringPool,
								  MSecurityPolicy* aSecurityPolicy,
								  MWspCOSessionCallback& aSessionCB,
								  MWspProxyInfoProvider& aProxyInfoProv,
							      MWspCapabilityProvider& aCapProv,
							      MWspSessionHeadersProvider& aSessHdrProv);

protected: // attributes

	/** Handle for a string pool used by the WSP transport handler.  This is owned
		and managed elsewhere.
	*/
	//##ModelId=3C4C453101A2
	RStringPool iStringPool;

	/** An optional security policy plug-in.  If a plug-in was not supplied, the
		value is NULL.
	*/
	//##ModelId=3C4C4531018E
	MSecurityPolicy* iSecurityPolicy;

	/** The client's callback for session events
	*/
	//##ModelId=3C4C4531017C
	MWspCOSessionCallback& iSessionCB;

	/** The client's provider of proxy information
	*/
	//##ModelId=3C4C45310170
	MWspProxyInfoProvider& iProxyInfoProv;

	/** The client's provider of capabilities information
	*/
	//##ModelId=3C4C4531015C
	MWspCapabilityProvider& iCapProv;

	/** THe client's provider of session headers
	*/
	//##ModelId=3C4C45310148
	MWspSessionHeadersProvider& iSessHdrProv;

private: // attributes
#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
	/** D'tor Key identification required for ECOM
		@internalAll
	*/
#else
	/** D'tor Key identification required for ECOM
	*/
#endif	//SYMBIAN_ENABLE_SPLIT_HEADERS
	//##ModelId=3C4C45310134
	TUid iDtor_ID_Key;
	};

#include <wsp/cwsptransporthandler.inl>

#endif // __CWSPTRANSPORTHANDLER_H__