XATopicConnectionFactory (Java EE 5)

XATopicConnectionFactory 接口是可选的。JMS 提供者不需要支持此接口。此接口供 JMS 提供者使用，以支持事务环境。强烈建议客户端程序使用其环境中可用的事务支持，而不是直接使用这些 XA 接口。

An XATopicConnectionFactory provides the same create options as a TopicConnectionFactory (optional).

The XATopicConnectionFactory interface is optional. JMS providers are not required to support this interface. This interface is for use by JMS providers to support transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.

Version:

1.1 February 2, 2002

Author:

Mark Hapner, Rich Burridge, Kate Stout

See Also:

TopicConnectionFactory, XAConnectionFactory

public XATopicConnection createXATopicConnection() throws JMSException
创建带有默认用户身份的 XA 主题连接。以停止模式创建连接。在显式调用 Connection.start 方法前，不会传送任何消息。

return	新建的 XA 主题连接
Throws	JMSException: 如果 JMS 提供者由于某个内部错误无法创建 XA 主题连接。
Throws	JMSSecurityException: 如果客户端验证由于无效用户名或密码失败。

英文文档：

createXATopicConnection

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.

public XATopicConnection createXATopicConnection(String userName, String password) throws JMSException
创建带有指定用户身份的 XA 主题连接。以停止模式创建连接。在显式调用 Connection.start 方法前，不会传送任何消息。

userName	调用者的用户名
password	调用者的密码
return	新建的 XA 主题连接
Throws	JMSException: 如果 JMS 提供者由于某个内部错误无法创建 XA 主题连接。
Throws	JMSSecurityException: 如果客户端验证由于无效用户名或密码失败。

英文文档：

createXATopicConnection

XATopicConnection createXATopicConnection(String userName,
                                          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 name

password - 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.

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.