O'Reilly - Java Message Service

A.1.8 JMSException
Java Message Service
The JMSException is the base exception type for all exceptions thrown by the JMS API. It
may provide an error message describing the cause of the exception, a provider-specific
error code, and possibly a reference to the exception that caused the JMS exception:
public class JMSException extends java.lang.Exception {
public JMSException(java.lang.String reason) { .. }
public JMSException(java.lang.String reason,
java.lang.String errorCode) { .. }
public String getErrorCode( ) { .. }
public Exception getLinkedException( ) { .. }
public void setLinkedException(java.lang.Exception ex) { .. }
}
While the JMSException is usually declared as the exception type thrown from methods in
the JMS API, the actual exception thrown may be one of a dozen subtypes, which are
enumerated below. The descriptions of these exception types are derived from Sun
Microsystems' JMS API documentation and they implement the methods defined by the
JMSException super type:
IllegalStateException
Thrown when a method is invoked illegally or inappropriately, or if the provider is
not in an appropriate state when the method is called. For example, this exception
should be thrown if Session.commit( ) is called on a non-transacted session.
InvalidClientIDException
Thrown when a client attempts to set a connection's client ID to a value that the
provider rejects.
InvalidDestinationException
Thrown when the provider doesn't understand the destination, or the destination is no
longer valid.
InvalidSelectorException
Thrown when the syntax of a message selector is invalid.
JMSSecurityException
Thrown when a provider rejects a username/password. Also thrown when a security
restriction prevents a method from completing.
MessageEOFException
Thrown if a stream ends unexpectedly when a StreamMessage or BytesMessage is
being read.
144