Sun Java logo     上一页      目录      索引      下一页     

Sun logo
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 JavaBean

ResourceAdapter 配置可用于配置默认 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
   /jms

addressListBehavior

一个字符串,指定资源适配器连接到 Message Queue 服务的方式。值为 PRIORITYRANDOM

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

一个布尔值,指定在连接中断后是否尝试重新连接。

重新连接尝试的行为是由 reconnectIntervalreconnectAttempts 值管理的。

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 服务的方式。值为 PRIORITYRANDOM

PRIORITY 连接通过选择地址列表 (addressList) 中指定的第一个代理来选择 Message Queue 代理。

RANDOM 连接从地址列表中随机选择 Message Queue 代理。

连接中断后进行重新连接时,PRIORITY RANDOM 的作用是相同的。重新连接尝试将从连接中断的代理开始。如果该尝试失败,连接尝试按顺序处理活动地址列表中的条目。

PRIORITY

addressListIterations

循环访问地址列表的次数。此值适用于初始连接以及后来的重新连接尝试。

1

clientID

用于来自此受管理连接工厂的连接的客户机标识符。

password

(可选)用于连接的密码。

如果未设置此值,连接将使用为 ResourceAdapter JavaBean 指定的密码(如表 17-1 中所述)。

guest

reconnectAttempts

尝试重新连接到地址列表中的单个条目的次数。

6

reconnectEnabled

一个布尔值,指定在连接中断后是尝试重新连接,还是进行新的连接尝试。

重新连接尝试是由 reconnectIntervalreconnectAttempts 属性管理的。

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 标准特有属性。

表 17-3 激活规范属性

名称

说明

默认值

acknowledgeMode

(可选)用于使用方的 JMS 会话确认模式。

这是标准的 EJB 2.1 和 J2EE CA 1.5 属性。

该值可以是 Auto-acknowledgeDups-ok-acknowledge

Auto-acknowledge

addressList

(可选)资源适配器代表消息端点所建立的连接的规范。

此属性是 Message Queue JMS 资源适配器的特定属性。

有效值必须符合消息服务连接地址语法。


ResourceAdapter JavaBean 配置中的 addressList 继承。

clientId

为此使用方创建的 JMS 连接所使用的 JMS 客户机 ID。

如果将 subscriptionDurability 属性设置为 Durable,则必须设置此属性。

这是标准的 EJB 2.1 和 J2EE CA 1.5 属性。

customAcknowledgeMode

一个字符串,指定 MDB 消息使用的模式。

此属性的有效值是 No_acknowledge 或 null。

只能将 No_acknowledge 模式用于非事务、非长期的主题订阅。如果对事务订阅或长期订阅使用此设置,订阅激活将失败。

destination

MDB 所使用消息的目标的名称。

这是必需的属性。它是标准的 EJB 2.1 和 J2EE CA1.5 属性。

对于 Message Queue 目标受管理对象,必须将该值设置为 destinationName 属性的值。

destinationType

destination 属性指定的目标类型。有效值是 javax.jms.Queuejavax.jms.Topic

这是必需的属性。它是标准的 EJB 2.1 和 J2EE CA1.5 属性。

endpointExceptionRedelivery
Attempts

消息传送期间当 MDB 抛出异常时,向 MDB 重新传送消息的次数。

6

messageSelector

(可选)用于对传送到使用方的消息进行过滤的 JMS 消息选择器。此值的类型是字符串。

这是标准的 EJB 2.1 和 J2EE CA 1.5 属性。

sendUndeliverableMsgsToDMQ

一个布尔值,指定当 MDB 抛出运行时异常且重新传送尝试次数超出 endpointExceptionRedeliveryAttempts 值时,是否将消息置于停用消息队列中。

如果为 false,Message Queue 代理将尝试将消息重新传送到任何有效的使用方,包括相同的 MDB。

true

subscriptionDurability

一个字符串,指定某一主题目标的使用方是长期的还是非长期的。该值可以是 NonDurableDurable

对于非长期订阅,此属性是可选的;而对于长期订阅,则是必需的。如果将此值设置为 Durable,则还必须设置属性 clientIDsubscriptionName

这是标准的 EJB 2.1 和 J2EE CA1.5 属性,只有将 destinationType 属性设置为 avax.jms.Topic 时才有效。

NonDurable

subscriptionName

一个字符串,用于对长期订阅进行命名。

如果将 subscriptionDurability 属性设置为 Durable,则必须设置此属性。

这是标准的 EJB 2.1 和 J2EE CA 1.5 属性。



上一页      目录      索引      下一页     


文件号码 819-2219。   版权所有 2005 Sun Microsystems, Inc. 保留所有权利。