--- a/epoc32/include/http/rhttptransaction.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/http/rhttptransaction.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,225 @@
-rhttptransaction.h
+// 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+
+
+/**
+ @file RHTTPTransaction.h
+ @warning : This file contains Rose Model ID comments - please do not delete
+*/
+
+#ifndef __RHTTPTRANSACTION_H__
+#define __RHTTPTRANSACTION_H__ 
+
+// System includes
+#include <http/thttpevent.h>
+#include <http/rhttpresponse.h>
+#include <http/rhttprequest.h>
+#include <http/rhttptransactionpropertyset.h>
+#include <http/thttpfilterhandle.h>
+#include <http/mhttpdataoptimiser.h>
+
+// Forward declarations
+class CHTTPTransaction;
+class CTransaction;
+class MHTTPTransactionCallback;
+class RHTTPSession;
+class TCertInfo;
+class CCertificate;
+
+
+//##ModelId=3C4C18860091
+class RHTTPTransaction 
+/**
+A HTTP Transaction. This encapsulates 1 HTTP request and
+response. A Transaction is associated with a session, and must be
+created using the session's CreateTransactionL method.
+@publishedAll
+@released
+@see RHTTPSession
+@see RHTTPSession::CreateTransactionL
+*/
+	{
+ public:
+	/** 
+		Default (uninitialised) constructor
+	*/
+	//##ModelId=3C4C188600F5
+	inline RHTTPTransaction();
+
+	/** Submits a transaction. Once all the headers and other details
+		have been set up, this call actualy causes the request to be
+		made.
+		@leave KErrNoMemory There was not enough memory.
+	*/
+	//##ModelId=3C4C188600ED
+	IMPORT_C void SubmitL(THTTPFilterHandle aStart = 
+						  THTTPFilterHandle::EClient);
+
+	/** Notify HTTP of the availability of more request body data,
+		when submitting body data in several parts.
+		
+		@param aStart The filter supplying the new data. This will almost always be the client (default value)
+		@leave KErrNoMemory There was not enough memory.
+	*/
+	//##ModelId=3C4C188600EB
+	IMPORT_C void NotifyNewRequestBodyPartL(THTTPFilterHandle aStart = 
+											 THTTPFilterHandle::EClient);
+
+	/** Sends a status message to all relevant filters. This function
+		is predominantly used by filters, rather than by the client.
+		@param aStatus The status message to send.  
+		@param aDirection The direction down the filter queue that this event 
+		will be propogated.
+		@leave KErrNoMemory There was not enough memory.
+	*/
+	//##ModelId=3C4C188600E2
+	IMPORT_C void SendEventL(THTTPEvent aStatus, 
+							 THTTPEvent::TDirection aDirection, 
+							 THTTPFilterHandle aStart);
+
+	/** Gets the response. Note that the returned response may not be
+		valid if it hasn't been created yet.
+		@see RHTTPMessage::IsValid()
+	*/
+//##ModelId=3C4C188600E1
+	IMPORT_C RHTTPResponse Response() const;
+
+	/// Gets the request.
+	//##ModelId=3C4C188600DA
+	IMPORT_C RHTTPRequest Request() const;
+
+	/// Returns the session associated with the transaction.
+	//##ModelId=3C4C188600D9
+	IMPORT_C RHTTPSession Session() const;
+
+	/** Returns the transaction's property set. This is used by filters
+		to store transaction-specific information, and by clients to
+		specify things like reload or no cache behaviour.
+	*/
+	//##ModelId=3C4C188600D8
+	IMPORT_C RHTTPTransactionPropertySet PropertySet() const;
+
+	/** Cancels the transaction.
+	
+		@param aStart The entity that is initiating the cancel (defaults
+		to the client). See THTTPFilterHandle for the values this can take.
+	*/
+	//##ModelId=3C4C188600CF
+	IMPORT_C void Cancel(THTTPFilterHandle aStart = 
+						 THTTPFilterHandle::EClient);
+
+	/** Closes the transaction and frees all owned resources.
+		Transactions must be opened using RHTTPSession::OpenTransactionL.
+		It is also closed when you close the session.
+	 */
+	//##ModelId=3C4C188600CE
+	IMPORT_C void Close();
+
+	/** This function should be called by filters when they have
+	 failed due to running out of memory. It cancels the transaction
+	 and sends the synchronous events EUnrecoverableError and EFailed
+	 to the client to inform it of the failure. For instance in a
+	 filter that attempts to send an event to the client from a
+	 MHFRunError to inform the client of a failure, if the call to
+	 SendEventL leaves, Fail() may be used to 'give up'. */
+	//##ModelId=3C4C188600C7
+	IMPORT_C void Fail(THTTPFilterHandle aStart = 
+					   THTTPFilterHandle::ECurrentFilter);
+
+	/** Equality operator to check if this transaction is the same as that one.
+		@param aTrans The transaction to compare this one to.
+	*/
+	//##ModelId=3C4C188600C5
+	TBool operator==(RHTTPTransaction aTrans) const;
+	/** Inequality operator
+		@param aTrans The transaction to compare this one to.
+	*/
+	//##ModelId=3C4C188600C3
+	TBool operator!=(RHTTPTransaction aTrans) const;
+	/** Obtain this transaction's ID, which is unique within its
+		session.  This is mostly used for producing a
+		slightly-meaningful way of identifying transactions in logging
+		code.
+		@return The transaction ID.  
+	*/
+	//##ModelId=3C4C188600BB
+	IMPORT_C TInt Id() const;
+
+	/** Obtain the server certificate information for this transaction.  This function
+		should only be used for text-mode, for WSP use RHttpSession::ServerCert.
+		@see RHttpSession::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 WSP.
+		@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=3C4C188600B9
+	IMPORT_C TInt ServerCert(TCertInfo& aServerCert);
+
+	/** Obtain the server certificate information for this transaction.  This function
+		should only be used for HTTP. WSP should use RHttpSession::ServerCert.
+		@see RHttpSession::ServerCert
+		@internalAll
+		@prototype
+		@return	a CCertificate pointer to an CX509Certificate object.
+		Calling code can safely cast to CX509Certificate if using  "HTTP/TCP".
+		NULL returned if certificate information not found.
+	*/
+	IMPORT_C const CCertificate* ServerCert();
+	
+	/** Obtain the cipher suite information for this transaction.
+		@return RString containing the cipher suite as per RFC2246.
+	*/
+	IMPORT_C RString CipherSuite();
+	
+	/**Sets the HTTP data optimiser for the transaction.
+	@param aHttpOptimiser An object of the implementation of interface, MHttpDataOptimiser, supplied by the client.
+	@publishedPartner
+	*/
+ 	IMPORT_C void SetupHttpDataOptimiser (MHttpDataOptimiser& aHttpOptimiser);
+ 
+ 	/**Returns the object of the MHttpDataOptimiser implementation class.
+	@internalTechnology
+	*/
+ 	IMPORT_C MHttpDataOptimiser* HttpDataOptimiser ();
+
+private:
+	friend class RHTTPSession;
+	friend class CTransaction;
+
+ private:
+	//##ModelId=3C4C188600A7
+	CTransaction* iImplementation;
+	}; 
+
+inline TBool RHTTPTransaction::operator==(RHTTPTransaction aTrans) const
+	{
+	return (iImplementation == aTrans.iImplementation);
+	};
+inline TBool RHTTPTransaction::operator!=(RHTTPTransaction aTrans) const
+	{
+	return !(*this == aTrans);
+	};
+
+inline RHTTPTransaction::RHTTPTransaction()
+		: iImplementation(NULL)
+	{
+	}
+
+
+#endif // __RHTTPTRANSACTION_H__