Message Queue, v4.4 API Specification

## Uses of Package
javax.jms

Packages that use javax.jms
com.sun.messaging: Provides the Sun GlassFish(tm) Message Queue public classes.
com.sun.messaging.jms: Provides additional Sun GlassFish(tm) Message Queue classes for features that relate to the MQ implementation of the Java Message Service (JMS).
com.sun.messaging.jms.notification: Provides a notification API for the MQ client runtime to inform an application about a MQ connection state changes.
com.sun.messaging.xml: Provides additional Sun GlassFish(tm) Message Queue classes for features that relate to XML and SOAP messaging.
javax.jms: The Java Message Service (JMS) API provides a common way for Java programs to create, send, receive and read an enterprise messaging system's messages.

Classes in javax.jms used by com.sun.messaging
Connection A `Connection` object is a client's active connection to its JMS provider.
ConnectionFactory A `ConnectionFactory` object encapsulates a set of connection configuration parameters that has been defined by an administrator.
Destination A `Destination` object encapsulates a provider-specific address.
InvalidDestinationException This exception must be thrown when a destination either is not understood by a provider or is no longer valid.
JMSException This is the root class of all JMS API exceptions.
Queue A `Queue` object encapsulates a provider-specific queue name.
QueueConnection A `QueueConnection` object is an active connection to a point-to-point JMS provider.
QueueConnectionFactory A client uses a `QueueConnectionFactory` object to create `QueueConnection` objects with a point-to-point JMS provider.
Topic A `Topic` object encapsulates a provider-specific topic name.
TopicConnection A `TopicConnection` object is an active connection to a publish/subscribe JMS provider.
TopicConnectionFactory A client uses a `TopicConnectionFactory` object to create `TopicConnection` objects with a publish/subscribe JMS provider.
XAConnection The `XAConnection` interface extends the capability of `Connection` by providing an `XASession` (optional).
XAConnectionFactory The `XAConnectionFactory` interface is a base interface for the `XAQueueConnectionFactory` and `XATopicConnectionFactory` interfaces.
XAQueueConnection An `XAQueueConnection` provides the same create options as `QueueConnection` (optional).
XAQueueConnectionFactory An `XAQueueConnectionFactory` provides the same create options as a `QueueConnectionFactory` (optional).
XATopicConnection An `XATopicConnection` provides the same create options as `TopicConnection` (optional).
XATopicConnectionFactory An `XATopicConnectionFactory` provides the same create options as a `TopicConnectionFactory` (optional).

Classes in javax.jms used by com.sun.messaging.jms
Connection A `Connection` object is a client's active connection to its JMS provider.
IllegalStateException This exception is thrown when a method is invoked at an illegal or inappropriate time or if the provider is not in an appropriate state for the requested operation.
InvalidClientIDException This exception must be thrown when a client attempts to set a connection's client ID to a value that is rejected by a provider.
InvalidDestinationException This exception must be thrown when a destination either is not understood by a provider or is no longer valid.
InvalidSelectorException This exception must be thrown when a JMS client attempts to give a provider a message selector with invalid syntax.
JMSException This is the root class of all JMS API exceptions.
JMSSecurityException This exception must be thrown when a provider rejects a user name/password submitted by a client.
MessageEOFException This exception must be thrown when an unexpected end of stream has been reached when a `StreamMessage` or `BytesMessage` is being read.
MessageFormatException This exception must be thrown when a JMS client attempts to use a data type not supported by a message or attempts to read data in a message as the wrong type.
MessageNotReadableException This exception must be thrown when a JMS client attempts to read a write-only message.
MessageNotWriteableException This exception must be thrown when a JMS client attempts to write to a read-only message.
QueueConnection A `QueueConnection` object is an active connection to a point-to-point JMS provider.
QueueSession A `QueueSession` object provides methods for creating `QueueReceiver`, `QueueSender`, `QueueBrowser`, and `TemporaryQueue` objects.
ResourceAllocationException This exception is thrown when a provider is unable to allocate the resources required by a method.
Session A `Session` object is a single-threaded context for producing and consuming messages.
TopicConnection A `TopicConnection` object is an active connection to a publish/subscribe JMS provider.
TopicSession A `TopicSession` object provides methods for creating `TopicPublisher`, `TopicSubscriber`, and `TemporaryTopic` objects.
TransactionInProgressException This exception is thrown when an operation is invalid because a transaction is in progress.
TransactionRolledBackException This exception must be thrown when a call to `Session.commit` results in a rollback of the current transaction.

Classes in javax.jms used by com.sun.messaging.jms.notification
JMSException This is the root class of all JMS API exceptions.

Classes in javax.jms used by com.sun.messaging.xml
Message The `Message` interface is the root interface of all JMS messages.
Session A `Session` object is a single-threaded context for producing and consuming messages.

Classes in javax.jms used by javax.jms
BytesMessage A `BytesMessage` object is used to send a message containing a stream of uninterpreted bytes.
Connection A `Connection` object is a client's active connection to its JMS provider.
ConnectionConsumer For application servers, `Connection` objects provide a special facility for creating a `ConnectionConsumer` (optional).
ConnectionFactory A `ConnectionFactory` object encapsulates a set of connection configuration parameters that has been defined by an administrator.
ConnectionMetaData A `ConnectionMetaData` object provides information describing the `Connection` object.
Destination A `Destination` object encapsulates a provider-specific address.
ExceptionListener If a JMS provider detects a serious problem with a `Connection` object, it informs the `Connection` object's `ExceptionListener`, if one has been registered.
JMSException This is the root class of all JMS API exceptions.
MapMessage A `MapMessage` object is used to send a set of name-value pairs.
Message The `Message` interface is the root interface of all JMS messages.
MessageConsumer A client uses a `MessageConsumer` object to receive messages from a destination.
MessageListener A `MessageListener` object is used to receive asynchronously delivered messages.
MessageProducer A client uses a `MessageProducer` object to send messages to a destination.
ObjectMessage An `ObjectMessage` object is used to send a message that contains a serializable object in the Java programming language ("Java object").
Queue A `Queue` object encapsulates a provider-specific queue name.
QueueBrowser A client uses a `QueueBrowser` object to look at messages on a queue without removing them.
QueueConnection A `QueueConnection` object is an active connection to a point-to-point JMS provider.
QueueConnectionFactory A client uses a `QueueConnectionFactory` object to create `QueueConnection` objects with a point-to-point JMS provider.
QueueReceiver A client uses a `QueueReceiver` object to receive messages that have been delivered to a queue.
QueueSender A client uses a `QueueSender` object to send messages to a queue.
QueueSession A `QueueSession` object provides methods for creating `QueueReceiver`, `QueueSender`, `QueueBrowser`, and `TemporaryQueue` objects.
ServerSession A `ServerSession` object is an application server object that is used by a server to associate a thread with a JMS session (optional).
ServerSessionPool A `ServerSessionPool` object is an object implemented by an application server to provide a pool of `ServerSession` objects for processing the messages of a `ConnectionConsumer` (optional).
Session A `Session` object is a single-threaded context for producing and consuming messages.
StreamMessage A `StreamMessage` object is used to send a stream of primitive types in the Java programming language.
TemporaryQueue A `TemporaryQueue` object is a unique `Queue` object created for the duration of a `Connection`.
TemporaryTopic A `TemporaryTopic` object is a unique `Topic` object created for the duration of a `Connection`.
TextMessage A `TextMessage` object is used to send a message containing a `java.lang.String`.
Topic A `Topic` object encapsulates a provider-specific topic name.
TopicConnection A `TopicConnection` object is an active connection to a publish/subscribe JMS provider.
TopicConnectionFactory A client uses a `TopicConnectionFactory` object to create `TopicConnection` objects with a publish/subscribe JMS provider.
TopicPublisher A client uses a `TopicPublisher` object to publish messages on a topic.
TopicSession A `TopicSession` object provides methods for creating `TopicPublisher`, `TopicSubscriber`, and `TemporaryTopic` objects.
TopicSubscriber A client uses a `TopicSubscriber` object to receive messages that have been published to a topic.
XAConnection The `XAConnection` interface extends the capability of `Connection` by providing an `XASession` (optional).
XAConnectionFactory The `XAConnectionFactory` interface is a base interface for the `XAQueueConnectionFactory` and `XATopicConnectionFactory` interfaces.
XAQueueConnection An `XAQueueConnection` provides the same create options as `QueueConnection` (optional).
XAQueueSession An `XAQueueSession` provides a regular `QueueSession`, which can be used to create `QueueReceiver`, `QueueSender`, and `QueueBrowser` objects (optional).
XASession The `XASession` interface extends the capability of `Session` by adding access to a JMS provider's support for the Java Transaction API (JTA) (optional).
XATopicConnection An `XATopicConnection` provides the same create options as `TopicConnection` (optional).
XATopicSession An `XATopicSession` provides a regular `TopicSession`.

Message Queue, v4.4 API Specification

Copyright 2009 Sun Microsystems, Inc.
4150 Network Circle, Santa Clara, CA 95054, U.S.A. All Rights Reserved.