第 5 章 配置选项
本章列出了 AMQ OpenWire JMS 的可用配置选项。
JMS 配置选项设置为连接 URI 上的查询参数。如需更多信息，请参阅 第 4.3 节 “连接 URI”。
5.1. JMS 选项
- jms.username
- 客户端用于验证连接的用户名。
- jms.password
- 客户端用于验证连接的密码。
- jms.clientID
- 客户端应用到连接的客户端 ID。
- jms.closeTimeout
- JMS 关闭操作的超时时间（毫秒）。默认值为 15000（15 秒）。
- jms.connectResponseTimeout
- JMS 连接操作的超时时间（以毫秒为单位）。默认值为 0，即没有超时。
- jms.sendTimeout
- JMS 发送操作的超时时间（毫秒）。默认值为 0，即没有超时。
- jms.checkForDuplicates
- 如果启用，忽略重复的信息。它会被默认启用。
- jms.disableTimeStampsByDefault
- 如果启用，则不要时间戳信息。它默认是禁用的。
- jms.useAsyncSend
- 如果启用，则在不等待确认的情况下发送消息。它默认是禁用的。
- jms.alwaysSyncSend
- 如果启用，发送会在所有交付模式中等待确认。它默认是禁用的。
- jms.useCompression
- 如果启用，压缩消息正文。它默认是禁用的。
- jms.useRetroactiveConsumer
- 如果启用，不可更改的订阅者可接收在订阅启动前发布的消息。它默认是禁用的。
预定义策略选项
prefetch 策略决定每个 MessageConsumer 从远程 peer 获取的信息数，并保存在本地"prefetch"缓冲区中。
- jms.prefetchPolicy.queuePrefetch
- 用于队列的 prefetch 消息数。默认值为 1000。
- jms.prefetchPolicy.queueBrowserPrefetch
- 用于队列浏览器的 prefetch 消息数。默认值为 500。
- jms.prefetchPolicy.topicPrefetch
- 用于非持久性主题的 prefetch 消息数。默认值为 32766。
- jms.prefetchPolicy.durableTopicPrefetch
- 要预先填充持久主题的消息数量。默认值为 100。
- jms.prefetchPolicy.all
- 这可以用于一次性设置所有 prefetch 值。
prefetch 的值可能会影响消息到队列上的多个消费者的分发。更高的值可能会导致向每位消费者同时发送的批处理。当消费者以不同速度运作时，要达到更加均匀的循环分布，请使用较低的值。
重新传送策略选项
重新传送策略控制如何在客户端上处理重新传送消息。
- jms.redeliveryPolicy.maximumRedeliveries
- 在将消息发送到死信队列之前，尝试重新传送的次数。默认值为 6. -1 表示没有限制。
- jms.redeliveryPolicy.redeliveryDelay
-
重新传送尝试之间的时间（毫秒）。如果
initialRedeliveryDelay是 0，则会使用它。默认值为 1000（1 秒）。 - jms.redeliveryPolicy.initialRedeliveryDelay
- 第一次重新传送尝试前的时间（毫秒）。默认值为 1000（1 秒）。
- jms.redeliveryPolicy.maximumRedeliveryDelay
-
重新传送尝试之间的最长时间（毫秒）。如果启用了
useExponentialBackOff，则会使用它。默认值为 1000（1 秒）。-1 表示没有限制。 - jms.redeliveryPolicy.useExponentialBackOff
- 如果启用，在每次后续尝试中增加重新传送延迟。它默认是禁用的。
- jms.redeliveryPolicy.backOffMultiplier
- 增加重新传送延迟的倍数。默认值为 5。
- jms.redeliveryPolicy.useCollisionAvoidance
- 如果启用，请调整重新传送延迟略微上或下移以避免冲突。它默认是禁用的。
- jms.redeliveryPolicy.collisionAvoidanceFactor
- 用于调整重新传送延迟的倍数。默认值为 0.15。
- nonBlockingRedelivery
- 如果启用，则允许不按顺序重新传送，以避免行头阻止。它默认是禁用的。
