SessionNotFoundException

Overview

SessionNotFoundException, a special exception class shared between all three editions of Remoting SDK, is used to indicate when a remote call failed because no session was found - typically meaning that user login is required.

ROClientChannel will automatically catch exceptions of this class and call a dedicated delegate method (if provided) to allow the client to perform the necessary login procedure, and then re-attempt the original method call. If successful, the original call site initiating the request will be unaffected by the interruption and simply see the original call as having succeeded.

See Authentication and Login for more details on this topic.

Note: for compatibility reasons with other platforms, this exception class does not follow the naming conventions of other classes of the Remoting SDK for Xcode framework, and omits the "RO" prefix. Please also note that for compatibility with old Delphi clients, this exception class also gets registered under the name "EROSessionNotFound"; thus, EROSessionNotFound exceptions raised on a Delphi server will be properly thrown as SessionNotFoundException on Xcode clients.

Location


 

exception

Creates and initializes SessionNotFoundException

+ (SessionNotFoundException *) exception

exceptionForRetry

Represent special exception that is raised during handling SessionNotFoundException jus after login attempt in order to re-run the failed asynchronous request again. In most cases you don't need to deal with it directly. All happens automatically behind the sciene.

+ (SessionNotFoundException *) exceptionForRetry

exceptionName    (declared in ROException)

+ (nonnull NSString *) exceptionName

exceptionWithMessage:    (declared in ROException)

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

Parameters:

  • aExceptionMessage:

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)

- (nullable instancetype) initWithMessage:(nonnull NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage:

initWithMessage:fromServer:    (declared in ROException)

- (nullable instancetype) initWithMessage:(nonnull NSString *)aExceptionMessage fromServer:(BOOL)aFromServer

Parameters:

  • aExceptionMessage:
  • aFromServer:

retryingAsyncRequest

Boolean readonly flag shows should be failed asynchronous request restaeted after successfull login or not (YES by default).

@property (readonly) BOOL retryingAsyncRequest

serverStackTrace  copy    (declared in ROException)

@property (copy) nonnull 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

retryingAsyncRequest

Boolean readonly flag shows should be failed asynchronous request restaeted after successfull login or not (YES by default).

@property (readonly) BOOL retryingAsyncRequest

serverStackTrace  copy    (declared in ROException)

@property (copy) nonnull NSString *serverStackTrace

 

exception

Creates and initializes SessionNotFoundException

+ (SessionNotFoundException *) exception

exceptionForRetry

Represent special exception that is raised during handling SessionNotFoundException jus after login attempt in order to re-run the failed asynchronous request again. In most cases you don't need to deal with it directly. All happens automatically behind the sciene.

+ (SessionNotFoundException *) exceptionForRetry

exceptionName    (declared in ROException)

+ (nonnull NSString *) exceptionName

exceptionWithMessage:    (declared in ROException)

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

Parameters:

  • aExceptionMessage:

 

initWithMessage:    (declared in ROException)

- (nullable instancetype) initWithMessage:(nonnull NSString *)aExceptionMessage

Parameters:

  • aExceptionMessage:

initWithMessage:fromServer:    (declared in ROException)

- (nullable instancetype) initWithMessage:(nonnull NSString *)aExceptionMessage fromServer:(BOOL)aFromServer

Parameters:

  • aExceptionMessage:
  • aFromServer: