com.solacesystems.jms

Class SolTopicConnection

java.lang.Object

com.solacesystems.jms.SolConnection

com.solacesystems.jms.SolTopicConnection

All Implemented Interfaces:

SessionEventHandler, SolConnectionEventSource, SolConnectionIF, Connection, ExceptionListener, TopicConnection

Direct Known Subclasses:

SolXATopicConnection

public class SolTopicConnection
extends SolConnection
implements TopicConnection

Constructor Summary

Constructors

Constructor and Description
SolTopicConnection(JMSProperties properties, boolean connectionTypeXA)
SolTopicConnection(JMSProperties properties, boolean connectionTypeXA, String username, String password)

Method Summary

Modifier and Type	Method and Description
ConnectionConsumer	createConnectionConsumer(Topic topic, String messageSelector, ServerSessionPool sessionPool, int maxMessages) Creates a connection consumer for this connection (optional operation).
TopicSession	createTopicSession(boolean transacted, int acknowledgeMode) Creates a TopicSession object.

Methods inherited from class com.solacesystems.jms.SolConnection

addConnectionConsumer, close, createConnectionConsumer, createDefaultSubscriber, createDurableConnectionConsumer, createSession, deleteTemporaryQueue, deleteTemporaryTopic, getClientID, getClientName, getExceptionListener, getJCSMPProperties, getJMSProperties, getJMSState, getMetaData, getProperties, handleEvent, onException, remove, removeConnectionConsumer, setClientID, setConnectionEventListener, setExceptionListener, start, stop, toJCSMPProperties

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.jms.TopicConnection

createDurableConnectionConsumer

Methods inherited from interface javax.jms.Connection

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

Constructor Detail

SolTopicConnection

public SolTopicConnection(JMSProperties properties,
                          boolean connectionTypeXA,
                          String username,
                          String password)
                   throws JMSException

Throws:

JMSException

SolTopicConnection

public SolTopicConnection(JMSProperties properties,
                          boolean connectionTypeXA)
                   throws JMSException

Throws:

JMSException

Method Detail

createConnectionConsumer

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

Description copied from interface: TopicConnection

Creates a connection consumer for this connection (optional operation). This is an expert facility not used by regular JMS clients.

Specified by:

createConnectionConsumer in interface TopicConnection

Parameters:

topic - the topic to access

messageSelector - 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 the 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:

JMSException - if the TopicConnection object fails to create a connection consumer due to some internal error or invalid arguments for sessionPool and messageSelector.

InvalidDestinationException - if an invalid topic is specified.

InvalidSelectorException - if the message selector is invalid.

See Also:

ConnectionConsumer

createTopicSession

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

Description copied from interface: TopicConnection

Creates a TopicSession object.

Specified by:

createTopicSession in interface TopicConnection

Parameters:

transacted - indicates whether the session is transacted. Supported Since 5.1 SolOS-TR.

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, Session.DUPS_OK_ACKNOWLEDGE, and SupportedProperty.SOL_CLIENT_ACKNOWLEDGE.

Returns:

a newly created topic session

Throws:

JMSException - if the TopicConnection object fails to create a session due to some internal error or lack of support for the specific transaction and acknowledgement mode.

See Also:

Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE, SupportedProperty.SOL_CLIENT_ACKNOWLEDGE