4.19. 配置环队列
通常,AMQ Broker 中的队列使用第一in、第一出(FIFO)语义。这意味着代理将消息添加到队列的尾部,并将它们从头中删除。环队列是特殊的队列类型,包含指定的固定数量的消息。当新消息到达但队列已包含指定数量时,代理会删除队列头的消息来维护固定队列大小。
例如,假设一个环队列配置的大小为 3
和生成者,按顺序发送消息 A
、B
、C
和 D
。消息 C
到达队列后,队列中的消息数量已达到配置的环大小。此时,消息 A
位于队列的头部,而消息 C
则位于尾部。当消息 D
到达队列时,代理会将消息添加到队列的尾部。要维护固定的队列大小,代理会在队列头删除消息(即消息 A
)。消息 B
现在位于队列的头部。
4.19.1. 配置环队列 复制链接链接已复制到粘贴板!
以下步骤演示了如何配置环队列。
流程
-
打开 &
lt;broker_instance_dir> /etc/broker.xml
配置文件。 要在不匹配地址上为没有设置显式环大小的所有队列定义默认环大小,请在
address-setting
元素中为default-ring-size
指定一个值。例如:<address-settings> <address-setting match="ring.#"> <default-ring-size>3</default-ring-size> </address-setting> </address-settings>
<address-settings> <address-setting match="ring.#"> <default-ring-size>3</default-ring-size> </address-setting> </address-settings>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow default-ring-size
参数对于定义自动创建队列的默认大小特别有用。default-ring-size
的默认值为-1 (
即没有大小限制)。要在特定队列中定义环大小,请将
ring-size
键添加到queue
元素。指定一个值。例如:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
您可以在代理运行时更新 ring-size
的值。代理会动态应用更新。如果新的 ring-size
值低于先前值,代理不会立即从队列的头部删除消息,以强制实施新大小。发送到队列的新消息仍强制删除旧的消息,但队列不会达到其新的、缩减的大小,直到其自然地通过客户端正常使用消息。
4.19.2. 环队列故障排除 复制链接链接已复制到粘贴板!
本节描述了环队列的行为与其配置不同的情况。
发送的消息和回滚
当消息发送到消费者时,消息处于"in-between"状态,其中消息在技术上不再在队列中,但尚未确认。消息会一直处于 in-delivery 状态,直到被消费者确认。处于 in-delivery 状态的消息无法从环队列中删除。
由于代理无法删除 in-delivery 消息,因此客户端可以将比环队列所允许的更多消息发送到环队列。例如,请考虑以下情况:
-
生产者将三个消息发送到配置了
ring-size="3"
的环队列。 所有消息都会立即分配给消费者。
此时,
messageCount
=3
和 deliverCount
=3
。生产者向队列发送另一条消息。然后,将消息分配给消费者。
现在,
messageCount
=4
和deliverCount
=4
。消息计数为4
大于配置的环大小3
。但是,代理会义务来允许这种情况,因为它无法从队列中删除发送的消息。现在,假设消费者在不确认任何消息的情况下关闭。
在这种情况下,四个在发送中,未确认的消息将被取消回代理,并按它们所消耗的相反顺序添加到队列头。此操作会使队列超出其配置的环大小。由于环队列更喜欢队列尾部的消息,该队列会丢弃生成者发送的第一个消息,因为这是最后一个消息添加到队列的头。事务或核心会话回滚以同样的方式处理。
如果您直接使用核心客户端,或使用 AMQ Core Protocol JMS 客户端,您可以通过减少 consumerWindowSize
参数的值(默认为 1024 * 1024 字节)来最小化传输的消息数量。
调度的消息
当计划的消息发送到队列时,该消息不会立即添加到队列尾部,如正常消息。相反,代理将调度的消息保存在中间缓冲区中,并根据消息的详情将消息调度到队列的头部。但是,调度的消息仍然反映在队列的消息计数中。与 in-delivery 消息一样,此行为可能会使代理没有强制执行环队列大小。例如,请考虑以下情况:
在 12:00,生成者将消息
A
发送到配置了ring-size="3"
的环队列。该消息被调度为 12:05。此时,
messageCount
=1
和scheduledCount
=1
。在 12:01,生成者将消息
B
发送到同一环队列。now,
messageCount
=2
和scheduledCount
=1
。在 12:02 时,生成者将消息
C
发送到同一环队列。现在,
messageCount
=3
和scheduledCount
=1
。at 12:03, producer 将消息
D
发送到同一环队列。现在,
messageCount
=4
和scheduledCount
=1
。队列的消息计数现在为
4
,一个大于 配置的环大小3
。但是,计划的消息还没有在技术上在队列中(即,它位于代理中并计划放置到队列中)。在预定的 12:05 时,代理会将消息放在队列的头部。但是,由于环队列已达到其配置大小,因此调度的消息A
会立即被删除。
paged 信息
与发送中的调度消息和消息类似,页面的消息不计到代理强制执行的环队列大小,因为消息实际上是在地址级别上页面,而不是队列级别。页面的消息在技术上并非从技术上进行,尽管消息反映在队列的 messageCount
值中。
建议您不要将分页用于带有环队列的地址。相反,请确保整个地址可以适合内存。或者,将 address-full-policy
参数配置为 DROP
, BLOCK
或 FAIL
。
其他资源
- 当您配置 retroactive 地址时,代理会创建环队列的内部实例。如需更多信息,请参阅 第 4.20 节 “配置被动地址”。