<LSConnectionDelegate> Protocol Reference

The LSConnectionDelegate protocol receives notifications of connection activity and errors. More...

#import <LSConnectionDelegate.h>

List of all members.

Public Member Functions
(void)	- clientConnection:didStartSessionWithPolling:
	Notification that the session has been successfully opened.
(void)	- clientConnection:didReceiveNewBytes:
	Notification that the connection received new bytes from the Server.
(void)	- clientConnection:didChangeActivityWarningStatus:
	Notification that the connection did enter or did exit a stalled state.
(void)	- clientConnectionDidEstablish:
	Notification that the connection has been established.
(void)	- clientConnectionDidClose:
	Notification that the connection did close.
(void)	- clientConnection:didEndWithCause:
	Notification that the connection did end due to a Server-side decision.
(void)	- clientConnection:didReceiveDataError:
	Notification that a block of data received from the Server could not be correctly interpreted.
(void)	- clientConnection:didReceiveServerFailure:
	Notification that an unrecoverable exception signaled by the Server has been received.
(void)	- clientConnection:didReceiveConnectionFailure:
	Notification that an unrecoverable connection error has been detected.

---

Detailed Description

The LSConnectionDelegate protocol receives notifications of connection activity and errors.

---

Member Function Documentation

- (void) clientConnection:		(LSClient *)	client
didChangeActivityWarningStatus:		(BOOL)	warningStatus
			[optional]

Notification that the connection did enter or did exit a stalled state.

"Stalled" means that the LSClient object did not receive any new bytes for more then the probeWarningSecs specified on the LSConnectionInfo object when opening the connection.

Parameters:

client	The LSClient object that handles the connection.
warningStatus	YES if the connection did enter a stalled state, NO otherwise.

- (void) clientConnection:		(LSClient *)	client
didEndWithCause:		(int)	cause
			[optional]

Notification that the connection did end due to a Server-side decision.

Parameters:

client	The LSClient object that handles the connection.
cause	Specifies the cause that led the Server to close the connection.

- (void) clientConnection:		(LSClient *)	client
didReceiveConnectionFailure:		(LSPushConnectionException *)	failure
			[optional]

Notification that an unrecoverable connection error has been detected.

Parameters:

client	The LSClient object that handles the connection.
failure	The specific error that has been detected.

- (void) clientConnection:		(LSClient *)	client
didReceiveDataError:		(LSPushServerException *)	error
			[optional]

Notification that a block of data received from the Server could not be correctly interpreted.

Parameters:

client	The LSClient object that handles the connection.
error	The specific exception that explains the error.

- (void) clientConnection:		(LSClient *)	client
didReceiveNewBytes:		(int)	bytesLength
			[optional]

Notification that the connection received new bytes from the Server.

Parameters:

client	The LSClient object that handles the connection.
bytesLength	The number of bytes received

- (void) clientConnection:		(LSClient *)	client
didReceiveServerFailure:		(LSPushServerException *)	failure
			[optional]

Notification that an unrecoverable exception signaled by the Server has been received.

Parameters:

client	The LSClient object that handles the connection.
failure	The specific exception that has been received.

- (void) clientConnection:		(LSClient *)	client
didStartSessionWithPolling:		(BOOL)	polling
			[optional]

Notification that the session has been successfully opened.

Parameters:

client	The LSClient object that handles the connection.
polling	Tells if the session is in streaming mode or polling mode.

- (void) clientConnectionDidClose:

(LSClient *)

client

[optional]

Notification that the connection did close.

It may be received only after a call to closeConnection on the LSClient object.

Parameters:

client

The LSClient object that handles the connection.

- (void) clientConnectionDidEstablish:

(LSClient *)

client

[optional]

Notification that the connection has been established.

Parameters:

client

The LSClient object that handles the connection.

---

The documentation for this protocol was generated from the following file:

• LSConnectionDelegate.h