-
- All Superinterfaces:
ConnectionFactory
- All Known Subinterfaces:
XATopicConnectionFactory
public interface TopicConnectionFactory extends ConnectionFactory
A client uses aTopicConnectionFactory
object to createTopicConnection
objects with a publish/subscribe Jakarta Messaging provider.A
TopicConnectionFactory
can be used to create aTopicConnection
, from which specialized topic-related objects can be created. A more general, and recommended approach is to use theConnectionFactory
object.The
TopicConnectionFactory
object should be used to support existing code.- Since:
- JMS 1.0
- Version:
- Jakarta Messaging 2.0
- See Also:
ConnectionFactory
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description TopicConnection
createTopicConnection()
Creates a topic connection with the default user identity.TopicConnection
createTopicConnection(String userName, String password)
Creates a topic connection with the specified user identity.-
Methods inherited from interface jakarta.jms.ConnectionFactory
createConnection, createConnection, createContext, createContext, createContext, createContext
-
-
-
-
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 theConnection.start
method is explicitly called.- Returns:
- a newly created topic connection
- Throws:
JMSException
- if the Jakarta Messaging 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(String userName, 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 theConnection.start
method is explicitly called.- Parameters:
userName
- the caller's user namepassword
- the caller's password- Returns:
- a newly created topic connection
- Throws:
JMSException
- if the Jakarta Messaging 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.
-
-