ROInvalidUrlException

Overview

This exception is thrown by client channels and messages when they parse URL Schemes and configure themselves accordingly. There are two possible causes of this exception: * the URL passed is just misformed * the URL is valid but some part of it is not supported by the receiver object, e.g. you try to configure TCP channel with a HTTP-based URL

Location

 

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

exceptionWithInvalidPart:

Creates an exception instance and allows to specify the wrong part of the URL.

+ (ROInvalidUrlException *) exceptionWithInvalidPart:(NSString *)aPart

Parameters:

  • aPart: The specific part of the URL that is considered wrong

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

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

initWithInvalidPart:

Initializes the exception instance and allows to specify the wrong part of the URL.

- (id) initWithInvalidPart:(NSString *)aPart

Parameters:

  • aPart: The specific part of the URL that is considered wrong

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.

invalidPart  copy

Contains the specific part of the URL that is considered wrong. Contains the entire URL for the worst case.

@property (copy) NSString *invalidPart

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

invalidPart  copy

Contains the specific part of the URL that is considered wrong. Contains the entire URL for the worst case.

@property (copy) NSString *invalidPart

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

 

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

exceptionWithInvalidPart:

Creates an exception instance and allows to specify the wrong part of the URL.

+ (ROInvalidUrlException *) exceptionWithInvalidPart:(NSString *)aPart

Parameters:

  • aPart: The specific part of the URL that is considered wrong

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

 

initWithInvalidPart:

Initializes the exception instance and allows to specify the wrong part of the URL.

- (id) initWithInvalidPart:(NSString *)aPart

Parameters:

  • aPart: The specific part of the URL that is considered wrong

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.

See Also

URL Schemes Client Channels