javax::jms::TopicConnection Class Reference

A TopicConnection object is an active connection to a publish/subscribe JMS provider. More...

#include <javax_jms_TopicConnection.h>

Inheritance diagram for javax::jms::TopicConnection:

[legend]Collaboration diagram for javax::jms::TopicConnection:

[legend]List of all members.

Public Types
enum	{   xmogDefaultFlags = xmog_base::GLOBAL, xmogMajorVersion = 3, xmogMinorVersion = 2, xmogPatchVersion = 9,   xmogBuildNumber = 2047 }
typedef ::xmog_java_array_template< ::javax::jms::TopicConnection >	array1D
typedef ::xmog_java_array_template< ::xmog_java_array_template< ::javax::jms::TopicConnection > >	array2D
Public Member Functions
virtual ::javax::jms::ConnectionConsumer	createConnectionConsumer (const ::javax::jms::Topic &topic, const ::java::lang::String &messageSelector, const ::javax::jms::ServerSessionPool &sessionPool, jint maxMessages,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags)
	Creates a connection consumer for this connection (optional operation).
virtual ::javax::jms::ConnectionConsumer	createDurableConnectionConsumer (const ::javax::jms::Topic &topic, const ::java::lang::String &subscriptionName, const ::java::lang::String &messageSelector, const ::javax::jms::ServerSessionPool &sessionPool, jint maxMessages,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags)
	Create a durable connection consumer for this connection (optional operation).
virtual ::javax::jms::TopicSession	createTopicSession (bool transacted, jint acknowledgeMode,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags)
	Creates a TopicSession object.

---

Detailed Description

A TopicConnection object is an active connection to a publish/subscribe JMS provider.

A client uses a TopicConnection object to create one or more TopicSession objects for producing and consuming messages.

A TopicConnection can be used to create a TopicSession, from which specialized topic-related objects can be created. A more general, and recommended approach is to use the Connection object.

The TopicConnection object should be used to support existing code.

Author:

Mark Hapner

Rich Burridge

Kate Stout

---

Member Function Documentation

virtual ::javax::jms::ConnectionConsumer javax::jms::TopicConnection::createConnectionConsumer (  const ::javax::jms::Topic &  topic, const ::java::lang::String &  messageSelector, const ::javax::jms::ServerSessionPool &  sessionPool, jint  maxMessages, ::xmog_localenv *  p_xenv = NULL, xmog_flags  f_xflags = xmogDefaultFlags )

Creates 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. 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 p_xenv  the local call environment. The default value is NULL. f_xflags  the flags that allow control over the reference type and other internal matters. The default value is xmog_base::GLOBAL. Returns: the connection consumer

virtual ::javax::jms::ConnectionConsumer javax::jms::TopicConnection::createDurableConnectionConsumer (  const ::javax::jms::Topic &  topic, const ::java::lang::String &  subscriptionName, const ::java::lang::String &  messageSelector, const ::javax::jms::ServerSessionPool &  sessionPool, jint  maxMessages, ::xmog_localenv *  p_xenv = NULL, xmog_flags  f_xflags = xmogDefaultFlags )

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. 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 durable connection consumer maxMessages  the maximum number of messages that can be assigned to a server session at one time p_xenv  the local call environment. The default value is NULL. f_xflags  the flags that allow control over the reference type and other internal matters. The default value is xmog_base::GLOBAL. Returns: the durable connection consumer Reimplemented from javax::jms::Connection. Reimplemented in javax::jms::XATopicConnection.

virtual ::javax::jms::TopicSession javax::jms::TopicConnection::createTopicSession (  bool  transacted, jint  acknowledgeMode, ::xmog_localenv *  p_xenv = NULL, xmog_flags  f_xflags = xmogDefaultFlags )

Creates a TopicSession object. 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. p_xenv  the local call environment. The default value is NULL. f_xflags  the flags that allow control over the reference type and other internal matters. The default value is xmog_base::GLOBAL. Returns: a newly created topic session Reimplemented in javax::jms::XATopicConnection.

---

The documentation for this class was generated from the following file:

• javax_jms_TopicConnection.h

---