Table 1.A Exceptions¶
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 that an authentication failure occurred on the server. |
BadFilterException |
Subscribing | This typically indicates a syntax error in a filter expression. |
BadRegexTopicException |
Subscribing | Indicates that 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 |
Subscribe or 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. |
InvalidTransportOptionsExc
eption |
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. |
MessageTypeNotFoundExcepti
on |
Connecting | The message type specified in the URI was not found in AMPS. |
NameInUseException |
Connecting | The client name (specified
when instantiating
Client ) is already in
use on the server. |
NotEntitledException |
Connecting Subscribing | The user does not have permission for the requested command (logging on or subscribing). |
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—please contact AMPS support. |
SubscriptionAlreadyExistsE
xception |
Subscribing | A subscription has been
requested using the same
CommandId as another
subscription. Create a
unique CommandId for
every subscription. |
TimedOutException |
Anytime | A timeout occurred waiting for a response to a command. |
TransportTypeException |
Connecting | Thrown when a transport type, unknown to AMPS is selected in the URI. |
UnknownException |
Anytime | Thrown when an internal error occurs. Contact AMPS support immediately. |
Table 1A: Exceptions supported in Client and HAClient