Package org.objectweb.joram.client.jms

Class TopicConnection

java.lang.Object

org.objectweb.joram.client.jms.Connection

org.objectweb.joram.client.jms.TopicConnection

All Implemented Interfaces:

AutoCloseable, Connection, TopicConnection, ConnectionMBean

Direct Known Subclasses:

XATopicConnection

public class TopicConnection
extends Connection
implements TopicConnection

Implements the javax.jms.TopicConnection interface.

Nested Class Summary

Nested classes/interfaces inherited from class org.objectweb.joram.client.jms.Connection

Connection.AtomicCounter, Connection.Closer

Field Summary

Fields inherited from class org.objectweb.joram.client.jms.Connection

JMXBeanBaseName, logger, MESSAGE_ID_PREFIX_PROPERTY, messageConsumers, tracker

Constructor Summary

Constructors

Constructor	Description
TopicConnection()	Creates a TopicConnection instance.

Method Summary

Modifier and Type	Method	Description
ConnectionConsumer	createConnectionConsumer(Topic topic, String selector, ServerSessionPool sessionPool, int maxMessages)	API method.
ConnectionConsumer	createDurableConnectionConsumer(Topic topic, String subName, String selector, ServerSessionPool sessPool, int maxMessages)	API method.
TopicSession	createTopicSession(boolean transacted, int acknowledgeMode)	API method.

Methods inherited from class org.objectweb.joram.client.jms.Connection

addSession, checkCLMessageProducer, checkClosed, checkCLSession, checkConsumers, checkThread, cleanup, close, closeConnectionConsumer, closeMessageConsumer, closeSession, createConnectionConsumer, createSession, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, doClose, equals, getAsyncSend, getClientID, getCompressedMinSize, getCompressionLevel, getExceptionListener, getImplicitAck, getInInterceptors, getJMXBeanName, getMetaData, getOutInterceptors, getOutLocalAddress, getOutLocalPort, getProxyId, getQueueMessageReadMax, getRequestMultiplexer, getTopicAckBufferMax, getTopicActivationThreshold, getTopicPassivationThreshold, getTxPendingTimer, hashCode, isOpenMessageConsumer, isStopped, lockClientId, nextMessageId, nextSessionId, nextSubName, open, openMessageConsumer, registerMBean, setClientID, setExceptionListener, setJMXBeanBaseName, setProviderClientID, start, stop, syncRequest, toString, unregisterMBean

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.jms.Connection

close, createConnectionConsumer, createSession, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Constructor Detail

TopicConnection

public TopicConnection()

Creates a TopicConnection instance.

Method Detail

createConnectionConsumer

public ConnectionConsumer createConnectionConsumer(Topic topic,
                                                   String selector,
                                                   ServerSessionPool sessionPool,
                                                   int maxMessages)
                                            throws JMSException

API method. Creates a connection consumer for this connection, this is an expert facility needed for applications servers.

Specified by:

createConnectionConsumer in interface TopicConnection

Parameters:

topic - the topic to access.

selector - only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that there is no message selector for this message consumer.

sessionPool - the server session pool to associate with this connection consumer.

maxMessages - the maximum number of messages that can be assigned to a server session at one time.

Returns:

The connection consumer.

Throws:

IllegalStateException - If the connection is closed.

InvalidSelectorException - If the selector syntax is wrong.

InvalidDestinationException - If the target destination does not exist.

JMSException - If the method fails for any other reason.

createTopicSession

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

API method. Creates a TopicSession object.

Specified by:

createTopicSession in interface TopicConnection

Parameters:

transacted - indicates whether the session is transacted.

acknowledgeMode - indicates whether the consumer or the client will acknowledge any messages it receives; ignored if the session is transacted. Legal values are Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, and Session.DUPS_OK_ACKNOWLEDGE.

Returns:

A newly created session.

Throws:

IllegalStateException - If the connection is closed.

JMSException - In case of an invalid acknowledge mode.

createDurableConnectionConsumer

public ConnectionConsumer createDurableConnectionConsumer(Topic topic,
                                                          String subName,
                                                          String selector,
                                                          ServerSessionPool sessPool,
                                                          int maxMessages)
                                                   throws JMSException

API method.

Specified by:

createDurableConnectionConsumer in interface Connection

Specified by:

createDurableConnectionConsumer in interface TopicConnection

Overrides:

createDurableConnectionConsumer in class Connection

Parameters:

topic - the topic to access.

subName - durable subscription name.

selector - only messages with properties matching the message selector expression are delivered. A value of null or an empty string indicates that there is no message selector for this message consumer.

sessPool - the server session pool to associate with this connection consumer.

maxMessages - the maximum number of messages that can be assigned to a server session at one time.

Returns:

The durable connection consumer.

Throws:

IllegalStateException - If the connection is closed.

InvalidSelectorException - If the selector syntax is wrong.

InvalidDestinationException - If the target topic does not exist.

JMSException - If the method fails for any other reason.