O'Reilly - Java Message Service

A.1.2 Connection
Java Message Service
The Connection is the base interface for the TopicConnection and the QueueConnection. It
defines several general-purpose methods used by clients of the messaging system in
managing a JMS connection. Among these methods are the getMetaData( ), start( ),
stop( ), and close( ) methods:
public interface Connection {
public void close( ) throws JMSException;
public String getClientID( ) throws JMSException;
public ExceptionListener getExceptionListener( ) throws JMSException;
public ConnectionMetaData getMetaData( ) throws JMSException;
public void setClientID(java.lang.String clientID)
throws JMSException;
public void setExceptionListener(ExceptionListener listener)
throws JMSException;
public void start( ) throws JMSException;
public void stop( ) throws JMSException;
}
A Connection object represents a physical connection to a JMS provider for either point-topoint
(QueueConnection) or publish-and-subscribe (TopicConnection) messaging. A JMS
client might choose to create multiple connections from the same connection factory, but
this is rare as connections are relatively expensive (each connection requires a network
socket, I/O streams, memory, etc.). Creating multiple Session objects from the same
Connection object is considered more efficient, because sessions share access to the same
connection.
A.1.3 ConnectionFactory
The ConnectionFactory is the base type for the TopicConnectionFactory and the
QueueConnectionFactory, which are used in the publish-and-subscribe and point-to-point
messaging models, respectively.
The ConnectionFactory is implemented differently by each vendor, so configuration
options available vary from product to product. A connection factory might, for example,
be configured to manufacture connections that use a particular protocol, security scheme,
clustering strategy, etc.:
public interface ConnectionFactory {
}
A.1.4 ConnectionMetaData
This type of object is obtained from a Connection object (TopicConnection or
QueueConnection). It provides information describing the JMS connection and the JMS
provider. Information available includes the identity of the JMS provider, the JMS version
supported by the provider, JMS provider version numbers, and the JMS properties
supported:
public interface ConnectionMetaData {
public int getJMSMajorVersion( ) throws JMSException;
public int getJMSMinorVersion( ) throws JMSException;
public String getJMSProviderName( ) throws JMSException;
public String getJMSVersion( ) throws JMSException;
142