--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerprotocols/httptransportfw/inc/http/rhttpsession.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,323 @@
+// 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
+ @warning : This file contains Rose Model ID comments - please do not delete
+*/
+
+#ifndef __RHTTPSESSION_H__
+#define __RHTTPSESSION_H__ 
+
+// System includes
+#include <e32std.h>
+#include <uri8.h>
+#include <http/rhttpconnectioninfo.h>
+#include <http/rhttpfiltercollection.h>
+#include <http/rhttptransaction.h>
+#include <http/mhttpdataoptimiser.h>
+
+// Forward declarations
+class MHTTPTransactionCallback;
+class CHTTPSession;
+class MHTTPSessionEventCallback;
+class MHTTPFilterCreationCallback;
+class TCertInfo;
+class CCertificate;
+
+/**
+Constant to represent any HTTP Status code when registering filters.
+@publishedAll
+@released
+*/
+const TInt KAnyStatusCode = -1;
+
+
+//##ModelId=3C4C187B0280
+class RHTTPSession 
+/** 
+A session handle. A session is a set of HTTP transactions using
+the same connection settings (e.g. proxy) and the same set of filters.
+    Multi-homing support provided by HTTP framework enables clients to
+    specify Connection preferences through the session property 
+    EHttpSocketConnection.
+
+Note that RHTTPSession (and consequently the whole of HTTP)
+depends on the active scheduler; a scheduler must be installed
+when the session is opened and it must be running if a transaction
+is actually to do anything.
+@publishedAll
+@released
+@see RHTTPTransaction
+*/
+	{
+ public:
+	/** Constructor.
+		@post The session is closed. (It must be opened with OpenL)
+		@see OpenL */
+	//##ModelId=3C4C187B02EF
+	inline RHTTPSession();
+
+	/** Sets the session event callback.
+		Until it is set all incoming session events are consumed
+	*/
+	//##ModelId=3C4C187B02EA
+	IMPORT_C void SetSessionEventCallback(MHTTPSessionEventCallback* aSessionEventCallback);
+
+	/** Send an session event
+		@param aEvent. The session event to sent.
+	*/
+	//##ModelId=3C4C187B02E6
+	IMPORT_C void SendSessionEventL(THTTPSessionEvent aStatus, THTTPSessionEvent::TDirection aDirection, 
+							 THTTPFilterHandle aStart = THTTPFilterHandle::EClient);
+
+	/** Fail the session event
+	*/
+	IMPORT_C void FailSessionEvent(THTTPFilterHandle aStart = THTTPFilterHandle::EClient);
+
+	//##ModelId=3A49F701013F
+	/** Opens the session using the default protocol HTTP/TCP. 
+		This function leaves with an apropriate code if the open failed.
+		@pre The session is closed. An active scheduler is installed.
+		@post The session is open.
+	*/
+	//##ModelId=3C4C187B02DA
+ 	IMPORT_C void OpenL();
+
+	/** Opens the session using the protocol indicated by the parameter passed in.
+		This function leaves with an apropriate code if the open failed.
+		@param aProtocol The protocol required
+		@pre The session is closed. An active scheduler is installed.
+		@post The session is open.
+	*/
+	//##ModelId=3C4C187B02DB
+	IMPORT_C void OpenL(const TDesC8& aProtocol);
+
+	/** Opens the session using the protocol indicated by the parameter passed in.
+		This method should be used if configuring the installed filters is required.
+		Once construction if the session is complete the callback method passed in is
+		called passing in a TFilterConfigurationIterator to allow the filters that
+		are installed to be configured.
+		This function leaves with an apropriate code if the open failed.
+		@param aProtocol The protocol required
+		@param aSessionCallback The pointer to the object providing the call back method
+		@pre The session is closed. An active scheduler is installed.
+		@post The session is open.
+	*/
+	//##ModelId=3C4C187B02DD
+	IMPORT_C void OpenL(const TDesC8& aProtocol, MHTTPFilterCreationCallback* aSessionCallback);
+
+	/**	This is a static methods that lists all the available protocols by adding the 
+		prorocol descriptors to the descriptor array passed in. Any existing data in the
+		descriptor array passed in is deleted.
+		This function leaves if the descriptor array can not be updated with the appropriate
+		array code.
+		@param aProtocolArray A pointer array to heap based descriptors. The data in this
+		array will be deleted and filled with descriptors containing the available protocols
+		@see OpenL
+	*/
+	//##ModelId=3C4C187B02D4
+	IMPORT_C static void ListAvailableProtocolsL(RPointerArray<HBufC8>& aProtocolArray);
+
+	/** Creates a transaction. 
+		@pre The session is open
+		@param aURI The URI that the request will be sent to.
+		@param aCallback A callback for all status events relating to
+		this transaction.
+		@param aMethod The HTTP method to use (default: GET)
+		@leave KErrNoMemory There was not enough memory.
+	*/
+	//##ModelId=3C4C187B02D0
+	IMPORT_C RHTTPTransaction OpenTransactionL(const TUriC8& aURI, 
+									  MHTTPTransactionCallback& aCallback, 
+									  RStringF aMethod = RStringF());
+
+	/** Closes the session. All transactions will be stopped and closed 
+		@post The session and all open transactions in it are closed.
+	 */
+	//##ModelId=3C4C187B02C8
+	IMPORT_C void Close();
+
+
+	//##ModelId=3C4C187B02C7
+	IMPORT_C  static const TStringTable& GetTable();
+
+	/** Accessor for the HTTP string pool. 
+		@return A handle for the string pool used in HTTP.
+	 */
+	//##ModelId=3C4C187B02C6
+	IMPORT_C RStringPool StringPool() const;
+
+	/** Accessor for the connection info for this session, and which
+		is used for all transactions in the session. Note that by and
+		large, the connection info should be set up before the first
+		transaction is created.  @return A handle to the connection
+		inf.  */
+	//##ModelId=3C4C187B02BE
+	IMPORT_C RHTTPConnectionInfo ConnectionInfo() const;
+
+	/** Accessor for the filter collection. Note that the filter
+        collection can't be edited after the first transaction has
+        been created. */
+	//##ModelId=3C4C187B02BD
+	inline RHTTPFilterCollection FilterCollection() const;
+
+
+	/** Accessor for the session headers. These are headers that will get added to each request
+		They only become part of the transaction headers when a transaction is submitted and they will not 
+		replace headers that already exist in the transaction request 
+	*/
+	//##ModelId=3C4C187B02BC
+	IMPORT_C RHTTPHeaders RequestSessionHeadersL();
+
+
+	/** Accessor for the response session headers. These are headers that will get added to each response if the 
+	corresponding header doesn't already exist
+	*/
+	//##ModelId=3C4C187B02B6
+	IMPORT_C RHTTPHeaders ResponseSessionHeadersL();
+
+	/** Equality operator.
+		@param aTrans The session to compare this one to.
+	*/
+	//##ModelId=3C4C187B02B4
+	TBool operator==(RHTTPSession aTrans) const;
+	/** Inequality operator
+		@param aTrans The session to compare this one to.
+	*/
+
+	//##ModelId=3C4C187B02B2
+	TBool operator!=(RHTTPSession aTrans) const;
+
+	/** Obtain the server certificate information for this session.  This function
+		should only be used for WSP, for text-mode use RHttpTransaction::ServerCert.
+		@see RHttpTransaction::ServerCert
+		@param	aServerCert A client supplied object into which the certificate
+		information will be placed.
+		@return KErrNone if certificate has been completed, KErrNotSupported if
+		this function is called for text-mode.
+		@deprecated v9.2 onwards - maintained for compatibility with v9.1 and before
+					TCertInfo has been deprecated since v9.2. CCertificate may be used as an alternative.
+	*/
+	//##ModelId=3C4C187B02AA
+	IMPORT_C TInt ServerCert(TCertInfo& aServerCert);
+
+	#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
+	/** Obtain the server certificate information for this session.  This function
+		should only be used for WSP. HTTP should use RHttpTransaction::ServerCert.
+		@see RHttpSession::ServerCert
+		@prototype
+		@return	a CCertificate pointer to an CWTLSCertificate object.
+		Calling code can safely cast to CWTLSCertificate if using  "WSP/WSP".
+		NULL returned if certificate information not found.
+	*/
+	#else
+	/** Obtain the server certificate information for this session.  This function
+		should only be used for WSP. HTTP should use RHttpTransaction::ServerCert.
+		@see RHttpSession::ServerCert
+		@internalAll
+		@prototype
+		@return	a CCertificate pointer to an CWTLSCertificate object.
+		Calling code can safely cast to CWTLSCertificate if using  "WSP/WSP".
+		NULL returned if certificate information not found.
+	*/
+	#endif	//SYMBIAN_ENABLE_SPLIT_HEADERS
+	IMPORT_C const CCertificate* ServerCert();
+
+	/** Connect this WSP session. This function does nothing when called for text-mode.
+	*/
+	//##ModelId=3C4C187B02A9
+	IMPORT_C void ConnectL();
+
+	/** Disconnect this WSP session. This function does nothing when called for text-mode.
+	*/
+	//##ModelId=3C4C187B02A8
+	IMPORT_C void DisconnectL();
+
+	#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
+	/**Set the default Proxy for Http Session. This function reads default proxy information,if available, from CommsDat
+	and uses it for the current Session.
+	@internalAll
+	*/
+	IMPORT_C void SetupDefaultProxyFromCommsDatL();
+
+	#endif	//SYMBIAN_ENABLE_SPLIT_HEADERS
+
+	#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS	
+	/**Sets the HTTP data optimiser for the session.
+	@param aHttpOptimiser An object of the implementation of interface, MHttpDataOptimiser, supplied by the client.
+	*/
+	#else
+	/**Sets the HTTP data optimiser for the session.
+	@param aHttpOptimiser An object of the implementation of interface, MHttpDataOptimiser, supplied by the client.
+	@publishedPartner
+	@released
+	*/
+	#endif	//SYMBIAN_ENABLE_SPLIT_HEADERS
+	IMPORT_C void SetupHttpDataOptimiser (MHttpDataOptimiser& aHttpOptimiser);
+ 	
+	#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS	
+ 	/**Returns the object of the MHttpDataOptimiser implementation class.
+	*/
+	#else
+ 	/**Returns the object of the MHttpDataOptimiser implementation class.
+	@internalTechnology
+	*/
+	#endif	//SYMBIAN_ENABLE_SPLIT_HEADERS
+ 	IMPORT_C MHttpDataOptimiser* HttpDataOptimiser ();
+
+private:
+	friend class RHTTPFilterCollection;
+	friend class CHTTPSession;
+
+	//##ModelId=3C4C187B0296
+	CHTTPSession* iImplementation;
+};
+
+inline RHTTPSession::RHTTPSession()
+		: iImplementation(0)
+	{
+	}
+
+
+inline RHTTPFilterCollection RHTTPSession::FilterCollection() const
+	{
+	RHTTPFilterCollection c;
+	c.iImplementation = iImplementation;
+	return c;
+	}
+
+inline TBool RHTTPSession::operator==(RHTTPSession aTrans) const
+	{
+	return (iImplementation == aTrans.iImplementation);
+	};
+inline TBool RHTTPSession::operator!=(RHTTPSession aTrans) const
+	{
+	return !(*this == aTrans);
+	};
+
+
+
+inline RHTTPSession RHTTPFilterCollection::Session() const
+	{
+	RHTTPSession s;
+	s.iImplementation = iImplementation;
+	return s;
+	}
+
+
+
+
+#endif // __RHTTPSESSION_H__