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
- Reference: ROExceptions.h
- Namespace: RemObjectsSDK
- Ancestry: NSException | ROException | ROServerException | SessionNotFoundException
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:
- Authentication and Login
- ROClientChannel's clientChannel:needsLoginForException: delegate method