Collapse all Symbian^3 Product Developer Library

RExplicitHTTPSession Class Reference

class RExplicitHTTPSession

RExplicitHTTPSession is a wrapper around the RHTTPSession. This handle provides features which allows the application to prompt the user only once for the selection of an IAP during muliple connections within a session.

Public Member Functions
	RExplicitHTTPSession()
IMPORT_C void	CancelStart()
IMPORT_C void	Close()
IMPORT_C RHTTPSession &	HTTPSession()
IMPORT_C void	OpenL(const TUriC8 &, TUint32, TBool)
IMPORT_C void	StartConnection(TRequestStatus &)
RHTTPSession &	operator()()

Private Member Functions
void	BindConnectionL(TUint32, TBool)
TBool	UseProxyL(const TDesC8 &, HBufC8 *&)

Private Attributes
RConnection	iConnection
RHTTPSession	iHTTPSession
TUint32	iIap
RSocketServ	iSocketServ

Constructor & Destructor Documentation

RExplicitHTTPSession()

IMPORT_C

RExplicitHTTPSession

(

)

A default RExplicitHTTPSession constructor.

Member Functions Documentation

BindConnectionL(TUint32, TBool)

void	BindConnectionL	(	TUint32	aIap,
			TBool	aStartConnection
		)	[private]

Parameters

TUint32 aIap
TBool aStartConnection

CancelStart()

IMPORT_C void

CancelStart

(

)

This API is used to close the RConnection.

Close()

IMPORT_C void

(

)

Closes the handle to RExplicitHTTPSession. It also closes the handle to RHTTPSession, the RConnection and the RSocketServ.

HTTPSession()

IMPORT_C RHTTPSession &

HTTPSession

(

)

Returns a handle to the RHTTPSession.

OpenL(const TUriC8 &, TUint32, TBool)

IMPORT_C void	OpenL	(	const TUriC8 &	aUri,
			TUint32	aIapNumber = 0,
			TBool	aStartConnection = ETrue
		)

This is a wrapper for the session handle RHTTPSession. It opens a session and sets up the proxies and the network settings using the provided IAP. It also starts a connection using the connection preference settings in CommDb. This function leaves with an appropriate error code if the open failed.

Parameters

const TUriC8 & aUri	This is used to retrieve the proxy record. If no proxy is found for the given URI, then no proxy will be used by default.
TUint32 aIapNumber = 0	This carries the IAP. If this is non-zero, it will be set as a connction preference and the user will not be prompted for an IAP.
TBool aStartConnection = ETrue	If set to ETrue, a new connection is started. This by default is set to ETrue.

StartConnection(TRequestStatus &)

IMPORT_C void

StartConnection

(

TRequestStatus &

aStatus

)

This API can be used to start an RConnection. It uses the connection preferences set while opening the handle to RExplicitHTTPSession to start the RConnection.