The following table details each of the exception types thrown by AMPS.
Exception
When
Notes
AlreadyConnectedException
Connecting
Thrown when connect() is called on a Client that is already connected.
AMPSException
Anytime
Base class for all AMPS exceptions.
AuthenticationException
Anytime
Indicates an authentication failure occurred on the server.
BadFilterException
Subscribing
This typically indicates a syntax error in a filter expression.
BadRegexTopicException
Subscribing
Indicates a malformed regular expression was found in the topic name.
CommandException
Anytime
Base class for all exceptions relating to commands sent to AMPS.
ConnectionException
Anytime
Base class for all exceptions relating to the state of the AMPS connection.
ConnectionRefusedException
Connecting
The connection was actively refused by the server. Validate that the server is running, that network connectivity is available, and the settings on the client match those on the server.
DisconnectedException
Anytime
No connection is available when AMPS needed to send data to the server or the user's disconnect handler threw an exception.
InvalidTopicException
SOW query
The topic is not configured for the requested operation. For example, a sow command was issued for a topic that is not in the SOW or a bookmark subscribe was issued for a topic that is not recorded in the transaction log.
InvalidTransportOptionsEx ception
Connecting
An invalid option or option value was specified in the URI.
InvalidUriException
Connecting
The URI string provided to connect() was formatted improperly.
MessageTypeException
Connecting
The class for a given transport's message type was not found in AMPS.
NameInUseException
Connecting
The client name (specified when instantiating Client) is already in use on the server.
RetryOperationException
Anytime
An error occurred that caused processing of the last command to be aborted. Try issuing the command again.
StreamException
Anytime
Indicates that data corruption has occurred on the connection between the client and server. This usually indicates an internal error inside of AMPS -- contact AMPS support.
SubscriptionAlreadyExists Exception
Subscribing
A subscription has been requested using the same command ID string as another subscription. Create a unique command ID string for every subscription.
TimedOutException
Anytime
A timeout occurred waiting for a response to a command.
TransportTypeException
Connecting
Thrown when a transport type is selected in the URI that is unknown to AMPS.
UnknownException
Anytime
Thrown when an internal error occurs. Contact AMPS support immediately.
UsageException
Changing the properties of an object
Thrown when the object is not in a valid state for setting the properties. For example, some properties of a Client (such as the name) cannot be changed while that client is connected to AMPS.