com.rabbitmq.jms.client

Class RMQConnection

java.lang.Object

com.rabbitmq.jms.client.RMQConnection

All Implemented Interfaces:

java.lang.AutoCloseable, javax.jms.Connection, javax.jms.QueueConnection, javax.jms.TopicConnection

public class RMQConnection
extends java.lang.Object
implements javax.jms.Connection, javax.jms.QueueConnection, javax.jms.TopicConnection

Implementation of the Connection, QueueConnection and TopicConnection interfaces. A RMQConnection object holds a list of RMQSession objects as well as the actual {link com.rabbitmq.client.Connection} object that represents the TCP connection to the RabbitMQ broker.

This implementation also holds a reference to the executor service that is used by the connection so that we can pause incoming messages.

Field Summary

Fields

Modifier and Type	Field and Description
static int	NO_CHANNEL_QOS

Constructor Summary

Constructors

Constructor and Description
RMQConnection(com.rabbitmq.client.Connection rabbitConnection) Creates an RMQConnection object, with default termination timeout of 15 seconds, a 2 seconds timeout for onMessage, and unlimited reads from QueueBrowsers.
RMQConnection(com.rabbitmq.client.Connection rabbitConnection, long terminationTimeout, int queueBrowserReadMax, int onMessageTimeoutMs) Creates an RMQConnection object.
RMQConnection(ConnectionParams connectionParams) Creates an RMQConnection object.

Method Summary

Modifier and Type	Method and Description
void	close() From the JMS Spec:
javax.jms.ConnectionConsumer	createConnectionConsumer(javax.jms.Destination destination, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.ConnectionConsumer	createConnectionConsumer(javax.jms.Queue queue, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.ConnectionConsumer	createConnectionConsumer(javax.jms.Topic topic, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.ConnectionConsumer	createDurableConnectionConsumer(javax.jms.Topic topic, java.lang.String subscriptionName, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.QueueSession	createQueueSession(boolean transacted, int acknowledgeMode)
javax.jms.Session	createSession()
javax.jms.Session	createSession(boolean transacted, int acknowledgeMode)
javax.jms.Session	createSession(int sessionMode)
javax.jms.ConnectionConsumer	createSharedConnectionConsumer(javax.jms.Topic topic, java.lang.String subscriptionName, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.ConnectionConsumer	createSharedDurableConnectionConsumer(javax.jms.Topic topic, java.lang.String subscriptionName, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
javax.jms.TopicSession	createTopicSession(boolean transacted, int acknowledgeMode)
java.lang.String	getClientID()
javax.jms.ExceptionListener	getExceptionListener()
javax.jms.ConnectionMetaData	getMetaData()
ReplyToStrategy	getReplyToStrategy() Gets the reply to strategy that should be followed if as reply to is found on a received message.
java.util.List<java.lang.String>	getTrustedPackages()
boolean	isStopped()
void	setClientID(java.lang.String clientID)
void	setExceptionListener(javax.jms.ExceptionListener listener)
void	start()
void	stop()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NO_CHANNEL_QOS

public static final int NO_CHANNEL_QOS

See Also:

Constant Field Values

Constructor Detail

RMQConnection

public RMQConnection(ConnectionParams connectionParams)

Creates an RMQConnection object.

Parameters:

connectionParams - parameters for this connection

RMQConnection

public RMQConnection(com.rabbitmq.client.Connection rabbitConnection,
                     long terminationTimeout,
                     int queueBrowserReadMax,
                     int onMessageTimeoutMs)

Creates an RMQConnection object.

Parameters:

rabbitConnection - the TCP connection wrapper to the RabbitMQ broker

terminationTimeout - timeout for close in milliseconds

queueBrowserReadMax - maximum number of messages to read from a QueueBrowser (before filtering)

onMessageTimeoutMs - how long to wait for onMessage to return, in milliseconds

RMQConnection

public RMQConnection(com.rabbitmq.client.Connection rabbitConnection)

Creates an RMQConnection object, with default termination timeout of 15 seconds, a 2 seconds timeout for onMessage, and unlimited reads from QueueBrowsers.

Parameters:

rabbitConnection - the TCP connection wrapper to the RabbitMQ broker

Method Detail

createSession

public javax.jms.Session createSession(boolean transacted,
                                       int acknowledgeMode)
                                throws javax.jms.JMSException

Specified by:

createSession in interface javax.jms.Connection

Throws:

javax.jms.JMSException

getClientID

public java.lang.String getClientID()
                             throws javax.jms.JMSException

Specified by:

getClientID in interface javax.jms.Connection

Throws:

javax.jms.JMSException

setClientID

public void setClientID(java.lang.String clientID)
                 throws javax.jms.JMSException

Specified by:

setClientID in interface javax.jms.Connection

Throws:

javax.jms.JMSException

getTrustedPackages

public java.util.List<java.lang.String> getTrustedPackages()

getMetaData

public javax.jms.ConnectionMetaData getMetaData()
                                         throws javax.jms.JMSException

Specified by:

getMetaData in interface javax.jms.Connection

Throws:

javax.jms.JMSException

getExceptionListener

public javax.jms.ExceptionListener getExceptionListener()
                                                 throws javax.jms.JMSException

Specified by:

getExceptionListener in interface javax.jms.Connection

Throws:

javax.jms.JMSException

setExceptionListener

public void setExceptionListener(javax.jms.ExceptionListener listener)
                          throws javax.jms.JMSException

Specified by:

setExceptionListener in interface javax.jms.Connection

Throws:

javax.jms.JMSException

start

public void start()
           throws javax.jms.JMSException

Specified by:

start in interface javax.jms.Connection

Throws:

javax.jms.JMSException

stop

public void stop()
          throws javax.jms.JMSException

Specified by:

stop in interface javax.jms.Connection

Throws:

javax.jms.JMSException

isStopped

public boolean isStopped()

Returns:

true if this connection is in a stopped state

close

public void close()
           throws javax.jms.JMSException

From the JMS Spec:

This call blocks until a receive or message listener in progress has completed. A blocked message consumer receive call returns null when this message consumer is closed.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface javax.jms.Connection

Throws:

javax.jms.JMSException

createTopicSession

public javax.jms.TopicSession createTopicSession(boolean transacted,
                                                 int acknowledgeMode)
                                          throws javax.jms.JMSException

Specified by:

createTopicSession in interface javax.jms.TopicConnection

Throws:

javax.jms.JMSException

createConnectionConsumer

public javax.jms.ConnectionConsumer createConnectionConsumer(javax.jms.Topic topic,
                                                             java.lang.String messageSelector,
                                                             javax.jms.ServerSessionPool sessionPool,
                                                             int maxMessages)
                                                      throws javax.jms.JMSException

Specified by:

createConnectionConsumer in interface javax.jms.TopicConnection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

javax.jms.JMSException

createQueueSession

public javax.jms.QueueSession createQueueSession(boolean transacted,
                                                 int acknowledgeMode)
                                          throws javax.jms.JMSException

Specified by:

createQueueSession in interface javax.jms.QueueConnection

Throws:

javax.jms.JMSException

createConnectionConsumer

public javax.jms.ConnectionConsumer createConnectionConsumer(javax.jms.Queue queue,
                                                             java.lang.String messageSelector,
                                                             javax.jms.ServerSessionPool sessionPool,
                                                             int maxMessages)
                                                      throws javax.jms.JMSException

Specified by:

createConnectionConsumer in interface javax.jms.QueueConnection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

javax.jms.JMSException

createConnectionConsumer

public javax.jms.ConnectionConsumer createConnectionConsumer(javax.jms.Destination destination,
                                                             java.lang.String messageSelector,
                                                             javax.jms.ServerSessionPool sessionPool,
                                                             int maxMessages)

Specified by:

createConnectionConsumer in interface javax.jms.Connection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

createDurableConnectionConsumer

public javax.jms.ConnectionConsumer createDurableConnectionConsumer(javax.jms.Topic topic,
                                                                    java.lang.String subscriptionName,
                                                                    java.lang.String messageSelector,
                                                                    javax.jms.ServerSessionPool sessionPool,
                                                                    int maxMessages)

Specified by:

createDurableConnectionConsumer in interface javax.jms.Connection

Specified by:

createDurableConnectionConsumer in interface javax.jms.TopicConnection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

createSession

public javax.jms.Session createSession(int sessionMode)
                                throws javax.jms.JMSException

Specified by:

createSession in interface javax.jms.Connection

Throws:

javax.jms.JMSException

createSession

public javax.jms.Session createSession()
                                throws javax.jms.JMSException

Specified by:

createSession in interface javax.jms.Connection

Throws:

javax.jms.JMSException

createSharedConnectionConsumer

public javax.jms.ConnectionConsumer createSharedConnectionConsumer(javax.jms.Topic topic,
                                                                   java.lang.String subscriptionName,
                                                                   java.lang.String messageSelector,
                                                                   javax.jms.ServerSessionPool sessionPool,
                                                                   int maxMessages)

Specified by:

createSharedConnectionConsumer in interface javax.jms.Connection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

createSharedDurableConnectionConsumer

public javax.jms.ConnectionConsumer createSharedDurableConnectionConsumer(javax.jms.Topic topic,
                                                                          java.lang.String subscriptionName,
                                                                          java.lang.String messageSelector,
                                                                          javax.jms.ServerSessionPool sessionPool,
                                                                          int maxMessages)

Specified by:

createSharedDurableConnectionConsumer in interface javax.jms.Connection

Throws:

java.lang.UnsupportedOperationException - - optional method not implemented

getReplyToStrategy

public ReplyToStrategy getReplyToStrategy()

Gets the reply to strategy that should be followed if as reply to is found on a received message.

Returns:

The reply to strategy.

Since:

2.9.0