Collapse all Symbian^3 Application Developer Library

CSdpRequesterBase Class Reference

class CSdpRequesterBase : public CActive

Inherits from

CSdpRequesterBase
- CActive
  - CBase

Public Member Functions
	~CSdpRequesterBase ()

Protected Member Functions
	CSdpRequesterBase ( RSdpSession &, CSdpAgentEng &)
void	DoCancel ()
void	IssueRequestL ()
void	NewRequestL (const TBTDevAddr &)
void	RequestCompleteL ()
void	Reset ()
void	RetrieveResponseL ()

Private Member Functions
void	ConnectL ()
void	Disconnect ()
void	RunL ()

Inherited Functions
	CActive::CActive(TInt)
	CActive::Cancel()
	CActive::Deque()
	CActive::Extension_(TUint,TAny &,TAny )
	CActive::IsActive()const
	CActive::IsAdded()const
	CActive::Priority()const
	CActive::RunError(TInt)
	CActive::SetActive()
	CActive::SetPriority(TInt)
	CActive::~CActive()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Public Member Enumerations
enum	TConnectState { EDisconnected , ERequesting , EIdle }

Inherited Enumerations
	CActive:TPriority

Protected Attributes
CSdpAgentEng &	iParent
TBTDevAddr	iRemoteAddress
RSdpAgent	iRequester
TPtr8	iResponse
TInt	iResultSize
RSdpSession &	iSdpSession
TConnectState	iState

Private Attributes
RTimer	iIdleTimer
HBufC8 *	iResponseHBuf
TInt	iRetryCount

Inherited Attributes
	CActive::iStatus

Constructor & Destructor Documentation

CSdpRequesterBase(RSdpSession &, CSdpAgentEng &)

CSdpRequesterBase	(	RSdpSession &	aSdpSession,
		CSdpAgentEng &	aParent
	)	[protected]

Constructor: This is where ESock session and the CSdpAgentEng parent are provided. Other member variables are given default values.

Parameters

RSdpSession & aSdpSession
CSdpAgentEng & aParent

~CSdpRequesterBase()

~CSdpRequesterBase

(

)

Destructor: Deletes buffer for responses. Ensures we are disconnected.

Member Functions Documentation

ConnectL()

void

ConnectL

(

)

[private]

Ask to connect to remote device address currently set-up in this active object. Note that we ensure that we are disconnected first...we could be connected to a different device.

Disconnect()

void

Disconnect

(

)

[private]

Bring down a currently existing connection.

DoCancel()

void

DoCancel

(

)

[protected, virtual]

Cancels current asynchronous request. This will be either an SDP query being performed through ESock or, if this CSdpRequesterBase is in the idle state, a timer (set-up to perform a disconnection after a defined length of time).

IssueRequestL()

void

IssueRequestL

(

)

[protected, pure virtual]

NewRequestL(const TBTDevAddr &)

void

NewRequestL

(

const TBTDevAddr &

aRemDev

)

[protected]

Attempts to connect to the remote device. This is the first thing to do on receipt of a new request.

Parameters

const TBTDevAddr & aRemDev

RequestCompleteL()

void

RequestCompleteL

(

)

[protected, pure virtual]

Reset()

void

Reset

(

)

[protected, virtual]

RetrieveResponseL()

void

RetrieveResponseL

(

)

[protected]

The initial response to a search or attribute request contains a buffer size. To obtain the actual result, the response buffer has to be made big enough, and then have the actual result copied into it from the server. RetrieveResponseL() does just this.

RunL()

void

RunL

(

)

[private, virtual]

Runs state machine. If no errors then:

         state disconnected		->		state requesting
									The request was stored before
									connection, and now is made.
	state requesting		->		state idle.
									The request has completed. See
									if any further requests come in
									over a brief period.
	state idle				->		state disconnected 
									if idle state interrupted by new request,
									this is notional - the RunL is immediately
									called again to set state to requesting
									and issue the actual request.