当前页面:
在线文档首页 >
Java Platform, Enterprise Edition v1.3.1 API Specifications
Java 2 Platform EE v1.3: Interface TopicConnectionFactory - Java Platform, Enterprise Edition v1.3.1 API Specifications
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 namepassword
- 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.