javax.jms
Interface TopicConnection

All Known Subinterfaces:

XATopicConnection

public interface TopicConnection

extends Connection

A TopicConnection is an active connection to a JMS Pub/Sub provider. A client uses a TopicConnection to create one or more TopicSessions for producing and consuming messages.

Version:

1.0 - 13 March 1998

Author:

Mark Hapner, Rich Burridge

See Also:

Connection, TopicConnectionFactory

Method Summary

ConnectionConsumer	createConnectionConsumer(Topic topic, java.lang.String messageSelector, ServerSessionPool sessionPool, int maxMessages) Create a connection consumer for this connection (optional operation).
ConnectionConsumer	createDurableConnectionConsumer(Topic topic, java.lang.String subscriptionName, java.lang.String messageSelector, ServerSessionPool sessionPool, int maxMessages) Create a durable connection consumer for this connection (optional operation).
TopicSession	createTopicSession(boolean transacted, int acknowledgeMode) Create a TopicSession

Methods inherited from interface javax.jms.Connection

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

Method Detail

createTopicSession

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

Create a TopicSession

Parameters:

transacted - if true, the session is transacted.

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

Returns:

a newly created topic session.

Throws:

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

See Also:

Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE

createConnectionConsumer

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

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

Parameters:

topic - the topic to access

messageSelector - only messages with properties matching the message selector expression are delivered

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 JMS Connection fails to create a a connection consumer due to some internal error or invalid arguments for sessionPool.

InvalidSelectorException - if the message selector is invalid.

See Also:

ConnectionConsumer

createDurableConnectionConsumer

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

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

Parameters:

topic - the topic to access

subscriptionName - durable subscription name

messageSelector - only messages with properties matching the message selector expression are delivered

sessionPool - the serversession pool to associate with this durable 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:

JMSException - if JMS Connection fails to create a a connection consumer due to some internal error or invalid arguments for sessionPool and message selector.

See Also:

ConnectionConsumer