TopicConnectionFactory (Java EE 6 )

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES All Classes

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.jms
Interface TopicConnectionFactory

All Superinterfaces:: ConnectionFactory

All Known Subinterfaces:: XATopicConnectionFactory

public interface TopicConnectionFactory
extends ConnectionFactory
extends ConnectionFactory

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

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

The TopicConnectionFactory object should be used to support existing code.

See Also:: ConnectionFactory

Method Summary
`TopicConnection`	`createTopicConnection()` Creates a topic connection with the default user identity.
`TopicConnection`	`createTopicConnection(java.lang.String userName, java.lang.String password)` Creates a topic connection with the specified user identity.

Methods inherited from interface javax.jms.ConnectionFactory
`createConnection, createConnection`

Method Detail

createTopicConnection

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

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.