![]() | |
Sun Java System Message Queue 3 2005Q1 管理指南 |
第 17 章
JMS 资源适配器属性参考利用 Message Queue JMS 资源适配器 (JMS RA),可以通过标准 J2EE 连接器体系结构 (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
资源适配器建立的到 Message Queue 服务的连接,它是使用消息服务地址格式指定的。
资源适配器提供默认值。
属性名称 addressList 是 Sun Java System Message Queue 特有的,但与标准属性 connectionURL 具有相同的含义。Sun Java System Message Queue 提供了这两个属性名。必须设置 connectionURL 或 ddressList;它们是等效的。
mq://localhost:7676
/jmsaddressListBehavior
一个字符串,指定资源适配器连接到 Message Queue 服务的方式。值为 PRIORITY 或 RANDOM。
PRIORITY 连接通过选择地址列表 (addressList) 中指定的第一个代理来选择 Message Queue 代理。
RANDOM 连接从地址列表中随机选择 Message Queue 代理。
连接中断后进行重新连接时,PRIORITY 和 RANDOM 的作用是相同的。重新连接尝试将从连接中断的代理开始。如果尝试失败,资源适配器将按顺序处理活动地址列表中的条目。
PRIORITY
addressListIterations
重复访问地址列表的次数。此值适用于初始连接以及后来的重新连接尝试。
1
connectionURL
资源适配器建立的到 Message Queue 服务的连接,它是使用消息服务地址格式指定的。
等效于 addressList 属性;请参见上面的说明以了解更详细的信息。
mq://localhost:7676
/jms
userName1
资源适配器连接到 Message Queue 服务时使用的默认用户名。
资源适配器提供默认值。
guest
password1
资源适配器连接到 Message Queue 服务时使用的默认密码。
资源适配器提供默认值。
guest
reconnectAttempts
尝试重新连接到地址列表中的单个条目的次数。在将 reconnectEnabled 设置为 true 时,将使用此属性。
6
reconnectEnabled
一个布尔值,指定在连接中断后是否尝试重新连接。
重新连接尝试的行为是由 reconnectInterval 和 reconnectAttempts 值管理的。
false
reconnectInterval
两次重新连接尝试的间隔时间(以毫秒为单位)。在将 reconnectEnabled 设置为 true 时,将使用此属性。
30000
1此属性是必需的。
ManagedConnectionFactory JavaBean受管理连接工厂提供并定义资源适配器为消息驱动 Bean 提供的连接。 对于所设置的属性,如果 ResourceAdapter JavaBean 具有类似属性,则该设置将取代为 ResourceAdapter Bean 指定的类似值。
表 17-2 列出并说明了 Message Queue 资源适配器提供的受管理连接工厂的可配置属性。
表 17-2 受管理连接工厂属性
名称
说明
默认值
addressList
一个来自此受管理连接工厂的连接列表。
此属性格式遵循消息服务 addressList,如表 17-1 中所述。如果未设置此值,连接将使用为 ResourceAdapter JavaBean 指定的 addressList 值(如该表中所述)。
无
addressListBehavior
一个字符串,指定资源适配器连接到 Message Queue 服务的方式。值为 PRIORITY 或 RANDOM。
PRIORITY 连接通过选择地址列表 (addressList) 中指定的第一个代理来选择 Message Queue 代理。
RANDOM 连接从地址列表中随机选择 Message Queue 代理。
连接中断后进行重新连接时,PRIORITY 和 RANDOM 的作用是相同的。重新连接尝试将从连接中断的代理开始。如果该尝试失败,连接尝试按顺序处理活动地址列表中的条目。
PRIORITY
addressListIterations
循环访问地址列表的次数。此值适用于初始连接以及后来的重新连接尝试。
1
clientID
用于来自此受管理连接工厂的连接的客户机标识符。
无
password
(可选)用于连接的密码。
如果未设置此值,连接将使用为 ResourceAdapter JavaBean 指定的密码(如表 17-1 中所述)。
guest
reconnectAttempts
尝试重新连接到地址列表中的单个条目的次数。
6
reconnectEnabled
一个布尔值,指定在连接中断后是尝试重新连接,还是进行新的连接尝试。
重新连接尝试是由 reconnectInterval 和 reconnectAttempts 属性管理的。
false
reconnectInterval
在尝试重新连接到 Message Queue 服务之前等待的最短时间间隔(以毫秒为单位)。
30000
userName
(可选)用于连接的用户名。
如果未设置此值,连接将使用为 ResourceAdapter JavaBean 指定的用户名(如表 17-1 中所述)。
guest
ActivationSpec JavaBean当指示资源适配器激活消息端点并将消息端点与消息驱动 Bean 相关联时,应用服务器将使用 ActivationSpec JavaBean 属性。
表 17-3 列出并说明了消息端点激活规范的可配置属性。该表列出了 Message Queue 资源适配器的特有属性以及企业 JavaBean 2.1 标准或 J2EE 连接器体系结构 (J2EE CA) 1.5 标准特有属性。