javax.jms
Interface TopicConnectionFactory

All Superinterfaces:

ConnectionFactory

All Known Subinterfaces:

XATopicConnectionFactory

public interface TopicConnectionFactory

extends ConnectionFactory

A client uses a TopicConnectionFactory object to create TopicConnection objects with a publish/subscribe JMS provider.

See Also:

ConnectionFactory

createTopicConnection

public TopicConnection createTopicConnection()
 throws JMSException

Creates a topic connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createTopicConnection

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

Creates a topic connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.