Collapse all Symbian^3 Application 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 .