XAQueueConnectionFactory (Java EE 5)

Java EE API


javax.jms Interface XAQueueConnectionFactory

All Superinterfaces:
ConnectionFactory, QueueConnectionFactory, XAConnectionFactory

public interface XAQueueConnectionFactory
extends XAConnectionFactory, QueueConnectionFactory


XAQueueConnectionFactory 提供的创建选项与 QueueConnectionFactory 提供的相同(可选)。

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

英文文档:

An XAQueueConnectionFactory provides the same create options as a QueueConnectionFactory (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 - 8 April 2002
Author:
Mark Hapner, Rich Burridge, Kate Stout
See Also:
QueueConnectionFactory, XAConnectionFactory

Method Summary
 XAQueueConnection
 XAQueueConnection
 
Methods inherited from interface javax.jms.XAConnectionFactory
 
Methods inherited from interface javax.jms.QueueConnectionFactory
 
Methods inherited from interface javax.jms.ConnectionFactory
 

Method Detail

public XAQueueConnection createXAQueueConnection() throws JMSException
创建带有默认用户身份的 XA 队列连接。以停止模式创建连接。在显式调用 Connection.start 方法前,不会传送任何消息。
return 新建的 XA 队列连接
ThrowsJMSException: 如果 JMS 提供者由于某个内部错误无法创建 XA 队列连接。
ThrowsJMSSecurityException: 如果客户端验证由于无效用户名或密码失败。
英文文档:

createXAQueueConnection

XAQueueConnection createXAQueueConnection()
                                          throws JMSException
Creates an XA queue 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 queue connection
Throws:
JMSException - if the JMS provider fails to create an XA queue connection due to some internal error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.

public XAQueueConnection createXAQueueConnection(String userName, String password) throws JMSException
创建带有指定用户身份的 XA 队列连接。以停止模式创建连接。在显式调用 Connection.start 方法前,不会传送任何消息。
userName 调用者的用户名
password 调用者的密码
return 新建的 XA 队列连接
ThrowsJMSException: 如果 JMS 提供者由于某个内部错误无法创建 XA 队列连接。
ThrowsJMSSecurityException: 如果客户端验证由于无效用户名或密码失败。
英文文档:

createXAQueueConnection

XAQueueConnection createXAQueueConnection(String userName,
                                          String password)
                                          throws JMSException
Creates an XA queue 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 queue connection
Throws:
JMSException - if the JMS provider fails to create an XA queue connection due to some internal error.
JMSSecurityException - if client authentication fails due to an invalid user name or password.


Submit a bug or feature

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

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!