Sun Java System Message Queue 3 2005Q4 管理指南 |
第 17 章
JMS 资源适配器属性参考利用 Message Queue JMS 资源适配器 (JMS Resource Adapter, JMS RA),可以通过标准 J2EE 连接器体系结构 (J2EE Connector Architecture, JCA) 将 Sun Java System Message Queue 和任何 J2EE 1.4 应用服务器集成。将 Message Queue JMS 资源适配器插入应用服务器后,在该应用服务器中部署的应用程序即可使用 Message Queue 来发送和接收 JMS 消息。
Message Queue JMS 资源适配器通过以下三个 JavaBean 组件来公开其配置属性:
要设置这些组件的属性值,请使用应用服务器提供的用于配置和部署资源适配器及部署 MDB 的工具。
本章列出并描述了 Message Queue JMS 资源适配器的配置属性。本章包含以下各节:
ResourceAdapter JavaBeanResourceAdapter 配置用于配置默认 JMS 资源适配器行为。表 17-1 列出并描述了可用来配置此 JavaBean 的属性。带脚注的属性是必需属性。
表 17-1 资源适配器属性
属性
默认值
描述
addressList1
mq://localhost:7676
/jms资源适配器建立的到 Message Queue 服务的连接,它是使用消息服务地址格式指定的。
资源适配器提供默认值。
属性名 addressList 是 Sun Java System Message Queue 特有的,但与标准属性 connectionURL 具有相同的含义。Sun Java System Message Queue 同时提供这两个属性名。只能设置 connectionURL 和 addressList 中的一个;它们是等效的。
addressListBehavior
PRIORITY
一个字符串,指定资源适配器连接到 Message Queue 服务的方式。值为 PRIORITY 或 RANDOM。
PRIORITY 连接通过选择地址列表 (addressList) 中指定的第一个条目来选择 Message Queue 代理。
RANDOM 连接从地址列表中随机选择 Message Queue 代理。
连接中断后的重新连接对于 PRIORITY 和 RANDOM 是相同的。尝试重新连接时,将从连接中断的代理开始。如果该尝试失败,资源适配器将依次尝试活动地址列表中的后续条目。
addressListIterations
1
循环访问地址列表的次数。该值适用于初始连接以及后来的重新连接尝试。
connectionURL
mq://localhost:7676
/jms
资源适配器建立的到 Message Queue 服务的连接,它是使用消息服务地址格式指定的。
等效于 addressList 属性;请参见上面的说明以了解更详细的信息。
userName1
guest
资源适配器连接到 Message Queue 服务时使用的默认用户名。
资源适配器提供默认值。
password1
guest
资源适配器连接到 Message Queue 服务时使用的默认密码。
资源适配器提供默认值。
reconnectAttempts
6
尝试重新连接到地址列表中的单个条目的次数。当 reconnectEnabled 设置为 true 时,将使用此属性。
reconnectEnabled
false
一个布尔值,指定在连接中断后是否尝试重新连接。
重新连接尝试的行为由 reconnectInterval 和 reconnectAttempts 的值控制。
reconnectInterval
30000
两次重新连接尝试的间隔时间(以毫秒为单位)。当 reconnectEnabled 设置为 true 时,将使用此属性。
1此属性是必需的。
ManagedConnectionFactory JavaBean受管理连接工厂提供并定义资源适配器为消息驱动 Bean 提供的连接。对于所设置的属性,如果 ResourceAdapter JavaBean 具有类似属性,则该设置将取代为 ResourceAdapter Bean 指定的类似值。
表 17-2 列出并描述了 Message Queue 资源适配器提供的受管理连接工厂的可配置属性。
表 17-2 受管理连接工厂属性
属性
默认值
描述
addressList
无
一个派生自此受管理连接工厂的连接列表。
此属性的格式遵循消息服务 addressList,如表 17-1 中所述。如果未设置该值,连接将使用为 ResourceAdapter JavaBean 指定的 addressList 值(如该表中所述)。
addressListBehavior
PRIORITY
一个字符串,指定资源适配器连接到 Message Queue 服务的方式。值为 PRIORITY 或 RANDOM。
PRIORITY 连接通过选择地址列表 (addressList) 中指定的第一个条目来选择 Message Queue 代理。
RANDOM 连接从地址列表中随机选择 Message Queue 代理。
连接中断后的重新连接对于 PRIORITY 和 RANDOM 是相同的。尝试重新连接时,将从连接中断的代理开始。如果该尝试失败,资源适配器将依次尝试活动地址列表中的后续条目。
addressListIterations
1
循环访问地址列表的次数。该值适用于初始连接以及后来的重新连接尝试。
clientID
无
用于派生自此受管理连接工厂的连接的客户端标识符。
password
guest
(可选)用于连接的密码。
如果未设置该值,连接将使用为 ResourceAdapter JavaBean 指定的密码(如表 17-1 中所述)。
reconnectAttempts
6
尝试重新连接到地址列表中的单个条目的次数。
reconnectEnabled
false
布尔值,指定在连接中断后是尝试重新连接,还是尝试建立新的连接。
重新连接尝试是由 reconnectInterval 和 reconnectAttempts 属性控制的。
reconnectInterval
30000
在尝试重新连接到 Message Queue 服务之前等待的最短时间(以毫秒为单位)。
userName
guest
(可选)用于连接的用户名。
如果未设置该值,连接将使用为 ResourceAdapter JavaBean 指定的用户名(如表 17-1 中所述)。
ActivationSpec JavaBean当应用服务器指示资源适配器激活消息端点并将消息端点与消息驱动 Bean 关联时,需要使用 ActivationSpec JavaBean 属性。
表 17-3 列出并描述了消息端点激活规范的可配置属性。该表列出了 Message Queue 资源适配器的特有属性以及企业 JavaBean 2.1 标准或 J2EE 连接器体系结构 (J2EE Connector Architecture, J2EE CA) 1.5 标准的特有属性。