ROConnectionReestablishedException

Overview

The special exception class that can be thrown on any remote request in case the client channel detects a possible half open socket condition. SuperHTTP channel uses two HTTP connections, one of them is constantly open to receive any incoming data from the server (remore requests responses or events data). It is called waiting connection. Due to network failures on the route between the client and the server this connaction can be broken without notifying the client side. In this case the client will never receive any answer from the server until this HTTP connection reestablished. Because no data can be received all remote request will fail by timeout. So in case the client detects a remote request timeout it forcibly reestablishes the waiting HTTP connection. Reestablishing the waiting connection also means that no requests that are currently waiting for answer will ever receive it. That's why all pending requests are made failed with this exception.

Location

 

exception

Creates an exception instance with the default error message.

+ (ROConnectionReestablishedException *) exception

exceptionName    (declared in ROException)

Return the exception name to be used to construct the class instance as NSException descendant. See NSException documentation for more details.

+ (NSString *) exceptionName

exceptionWithMessage:    (declared in ROException)

Constructs the excetion instance with the given text message (corresponds to reason of NSException).

+ (ROException *) exceptionWithMessage:(NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage: A text string decribing the exception

exceptionWithMessage:innerError:    (declared in ROSuperHTTPCommunicationException)

Creates an exception instance specifying error message and optional inner error object.

+ (ROSuperHTTPCommunicationException *) exceptionWithMessage:(NSString *)aExceptionMessage innerError:(NSError *)aError

Parameters:

  • aExceptionMessage: A text message describing the error condition
  • aError: The error object returned by the HTTP subsystem

fromServer  assign    (declared in ROException)

This flag is used to distinguish server side exceptions from client side ones. Set to YES for server side exceptions.

@property (assign) BOOL fromServer

initWithMessage:    (declared in ROException)

initializes a new ROException with the given error message.

- (id) initWithMessage:(NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage: A text string decribing the exception

initWithMessage:fromServer:    (declared in ROException)

Initializes a new ROException with the given error message and optionally marks the exception as having been received from a server by setting the fromServer property.

- (id) initWithMessage:(NSString *)aExceptionMessage fromServer:(BOOL)aFromServer

Parameters:

  • aExceptionMessage: A text string decribing the exception
  • aFromServer: Set to YES for server side exceptions.

initWithMessage:innerError:    (declared in ROSuperHTTPCommunicationException)

Initialize the exception instance specifying error message and optional inner error object.

- (id) initWithMessage:(NSString *)aExceptionMessage innerError:(NSError *)aError

Parameters:

  • aExceptionMessage: A text message describing the error condition
  • aError: The error object returned by the HTTP subsystem

innerError  retain    (declared in ROSuperHTTPCommunicationException)

The error object returned by the HTTP subsystem

@property (retain) NSError *innerError

serverStackTrace  copy    (declared in ROException)

Used to store the stack trace of server exception. The availability of this information depends on the server platform.

@property (copy) NSString *serverStackTrace

 

fromServer  assign    (declared in ROException)

This flag is used to distinguish server side exceptions from client side ones. Set to YES for server side exceptions.

@property (assign) BOOL fromServer

innerError  retain    (declared in ROSuperHTTPCommunicationException)

The error object returned by the HTTP subsystem

@property (retain) NSError *innerError

serverStackTrace  copy    (declared in ROException)

Used to store the stack trace of server exception. The availability of this information depends on the server platform.

@property (copy) NSString *serverStackTrace

 

exception

Creates an exception instance with the default error message.

+ (ROConnectionReestablishedException *) exception

exceptionName    (declared in ROException)

Return the exception name to be used to construct the class instance as NSException descendant. See NSException documentation for more details.

+ (NSString *) exceptionName

exceptionWithMessage:    (declared in ROException)

Constructs the excetion instance with the given text message (corresponds to reason of NSException).

+ (ROException *) exceptionWithMessage:(NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage: A text string decribing the exception

exceptionWithMessage:innerError:    (declared in ROSuperHTTPCommunicationException)

Creates an exception instance specifying error message and optional inner error object.

+ (ROSuperHTTPCommunicationException *) exceptionWithMessage:(NSString *)aExceptionMessage innerError:(NSError *)aError

Parameters:

  • aExceptionMessage: A text message describing the error condition
  • aError: The error object returned by the HTTP subsystem

 

initWithMessage:    (declared in ROException)

initializes a new ROException with the given error message.

- (id) initWithMessage:(NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage: A text string decribing the exception

initWithMessage:fromServer:    (declared in ROException)

Initializes a new ROException with the given error message and optionally marks the exception as having been received from a server by setting the fromServer property.

- (id) initWithMessage:(NSString *)aExceptionMessage fromServer:(BOOL)aFromServer

Parameters:

  • aExceptionMessage: A text string decribing the exception
  • aFromServer: Set to YES for server side exceptions.

initWithMessage:innerError:    (declared in ROSuperHTTPCommunicationException)

Initialize the exception instance specifying error message and optional inner error object.

- (id) initWithMessage:(NSString *)aExceptionMessage innerError:(NSError *)aError

Parameters:

  • aExceptionMessage: A text message describing the error condition
  • aError: The error object returned by the HTTP subsystem

See Also

ROSuperHTTPClientChannel Super HTTP Channel Asynchronous Calls