当前页面:
在线文档首页 >
Java Platform, Enterprise Edition v1.3.1 API Specifications
Java 2 Platform EE v1.3: Interface XATopicConnectionFactory - Java Platform, Enterprise Edition v1.3.1 API Specifications
javax.jms
Interface XATopicConnectionFactory
- All Superinterfaces:
- ConnectionFactory, TopicConnectionFactory, XAConnectionFactory
- public interface XATopicConnectionFactory
- extends XAConnectionFactory, TopicConnectionFactory
An XATopicConnectionFactory
provides the same create options as
a TopicConnectionFactory
(optional).
- See Also:
TopicConnectionFactory
,
XAConnectionFactory
createXATopicConnection
public XATopicConnection createXATopicConnection()
throws JMSException
- Creates an XA 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 XA topic connection
- Throws:
JMSException
- if the JMS provider fails to create an XA topic
connection due to some internal error.JMSSecurityException
- if client authentication fails due to
an invalid user name or password.
createXATopicConnection
public XATopicConnection createXATopicConnection(java.lang.String userName,
java.lang.String password)
throws JMSException
- Creates an XA 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 XA topic connection
- Throws:
JMSException
- if the JMS provider fails to create an XA topic
connection due to some internal error.JMSSecurityException
- if client authentication fails due to
an invalid user name or password.