com.lightstreamer.jms

Class LSTopicConnectionFactory

java.lang.Object

com.lightstreamer.jms.LSConnectionFactory

com.lightstreamer.jms.LSTopicConnectionFactory

All Implemented Interfaces:

ConnectionFactory, TopicConnectionFactory

public class LSTopicConnectionFactory
extends LSConnectionFactory
implements TopicConnectionFactory

A TopicConnectionFactory interface implementation that can be used used to create a topic connection with a JMS broker through an embedded JMS Extender client connection.

Constructor Summary

Constructors

Constructor and Description
LSTopicConnectionFactory() Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.
LSTopicConnectionFactory(java.lang.String serverAddress, java.lang.String jmsConnector) Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.
LSTopicConnectionFactory(java.lang.String serverAddress, java.lang.String adapterSet, java.lang.String jmsConnector) Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.

Method Summary

Modifier and Type	Method and Description
TopicConnection	createTopicConnection() Creates a new TopicConnection with an unspecified user identity.
TopicConnection	createTopicConnection(java.lang.String userName, java.lang.String password) Creates a new TopicConnection using the specified user name and password.

Methods inherited from class com.lightstreamer.jms.LSConnectionFactory

createConnection, createConnection, createContext, createContext, createContext, createContext, getAdapterSet, getConnectionListener, getJmsConnector, getServerAddress, setAdapterSet, setConnectionListener, setJmsConnector, setServerAddress

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.jms.ConnectionFactory

createConnection, createConnection, createContext, createContext, createContext, createContext

Constructor Detail

LSTopicConnectionFactory

public LSTopicConnectionFactory()

Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.

Uses the default adapter set name JMS, but leaves empty both the JMS connector name and the server address (to be specified later).

LSTopicConnectionFactory

public LSTopicConnectionFactory(java.lang.String serverAddress,
                                java.lang.String jmsConnector)

Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.

Uses the default adapter set name JMS and the specified JMS connector name and server address.

Parameters:

serverAddress - the URL of the JMS Extender to connect to

jmsConnector - the name of the JMS connector to use

LSTopicConnectionFactory

public LSTopicConnectionFactory(java.lang.String serverAddress,
                                java.lang.String adapterSet,
                                java.lang.String jmsConnector)

Creates an LSTopicConnectionFactory object that can create new TopicConnection objects.

Uses the specified adapter set name, JMS connector name and server address.

Parameters:

serverAddress - the URL of the JMS Extender to connect to

adapterSet - the name of the adapter set to use

jmsConnector - the name of the JMS connector to use

Method Detail

createTopicConnection

public TopicConnection createTopicConnection()
                                      throws JMSException

Creates a new TopicConnection with an unspecified user identity.

The connection is created in stopped mode. No messages will be delivered until the Connection.start() method is explicitly called on the TopicConnection object.

If a LSConnectionListener implementation has been set, its events will be called during connection creation.

Specified by:

createTopicConnection in interface TopicConnectionFactory

Returns:

the created TopicConnection

Throws:

JMSException - if the connection creation fails for some reason

createTopicConnection

public TopicConnection createTopicConnection(java.lang.String userName,
                                             java.lang.String password)
                                      throws JMSException

Creates a new TopicConnection using the specified user name and password.

The connection is created in stopped mode. No messages will be delivered until the Connection.start() method is explicitly called on the TopicConnection object.

If a LSConnectionListener implementation has been set, its events will be called during connection creation.

Specified by:

createTopicConnection in interface TopicConnectionFactory

Parameters:

userName - the user's name

password - the user's password

Returns:

the created TopicConnection

Throws:

JMSException - if the connection creation fails for some reason