Class RHTTPTransaction

class RHTTPTransaction;

Description

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.

Members

Defined in RHTTPTransaction:

• Cancel(THTTPFilterHandle)Cancels the transaction.
• CipherSuite()Obtain the cipher suite information for this transaction.
• Close()Closes the transaction and frees all owned resources. Transactions must be opene...
• Fail(THTTPFilterHandle)This function should be called by filters when they have failed due to running o...
• Id()constObtain this transaction's ID, which is unique within its session. This is mostly...
• NotifyNewRequestBodyPartL(THTTPFilterHandle)Notify HTTP of the availability of more request body data, when submitting body ...
• PropertySet()constReturns the transaction's property set. This is used by filters to store transac...
• RHTTPTransaction()Default (uninitialised) constructor
• Request()constGets the request.
• Response()constGets the response. Note that the returned response may not be valid if it hasn't...
• ServerCert(TCertInfo &)Obtain the server certificate information for this transaction. This function sh...
• Session()constReturns the session associated with the transaction.
• SubmitL(THTTPFilterHandle)Submits a transaction. Once all the headers and other details have been set up, ...
• operator!=(RHTTPTransaction)constInequality operator
• operator==(RHTTPTransaction)constEquality operator to check if this transaction is the same as that one.

See also:

• RHTTPSessionA session handle. A session is a set of HTTP transactions using the same connect...

inline RHTTPTransaction();

Description

Default (uninitialised) constructor

IMPORT_C void SubmitL(THTTPFilterHandle aStart=THTTPFilterHandle::EClient);

Description

Submits a transaction. Once all the headers and other details have been set up, this call actualy causes the request to be made.

Parameters

Leave codes

IMPORT_C void NotifyNewRequestBodyPartL(THTTPFilterHandle aStart=THTTPFilterHandle::EClient);

Description

Notify HTTP of the availability of more request body data, when submitting body data in several parts.

Parameters

Leave codes

IMPORT_C void SendEventL(THTTPEvent aStatus, THTTPEvent::TDirection aDirection, THTTPFilterHandle aStart);

Description

Sends a status message to all relevant filters. This function is predominantly used by filters, rather than by the client.

Parameters

Leave codes

IMPORT_C RHTTPResponse Response() const;

Description

Gets the response. Note that the returned response may not be valid if it hasn't been created yet.

Return value

IMPORT_C RHTTPRequest Request() const;

Description

Gets the request.

Return value

IMPORT_C RHTTPSession Session() const;

Description

Returns the session associated with the transaction.

Return value

IMPORT_C RHTTPTransactionPropertySet PropertySet() const;

Description

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.

Return value

IMPORT_C void Cancel(THTTPFilterHandle aStart=THTTPFilterHandle::EClient);

Description

Cancels the transaction.

Parameters

IMPORT_C void Close();

Description

Closes the transaction and frees all owned resources. Transactions must be opened using RHTTPSession::OpenTransactionL(const TUriC8 &,MHTTPTransactionCallback &,RStringF). It is also closed when you close the session.

IMPORT_C void Fail(THTTPFilterHandle aStart=THTTPFilterHandle::ECurrentFilter);

Description

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, RHTTPTransaction::Fail(THTTPFilterHandle) may be used to 'give up'.

Parameters

inline TBool operator==(RHTTPTransaction aTrans) const;

Description

Equality operator to check if this transaction is the same as that one.

Parameters

Return value

inline TBool operator!=(RHTTPTransaction aTrans) const;

Description

Inequality operator

Parameters

Return value

IMPORT_C TInt Id() const;

Description

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 value

IMPORT_C TInt ServerCert(TCertInfo &aServerCert);

Description

Obtain the server certificate information for this transaction. This function should only be used for text-mode, for WSP use RHttpSession::ServerCert.

Parameters

Return value

IMPORT_C RString CipherSuite();

Description

Obtain the cipher suite information for this transaction.

Return value