4.20. 配置被动地址
将地址配置为 被动 可以保留发送到该地址的消息,包括当队列还没有绑定到地址时。当队列稍后创建并绑定到地址时,代理会重新主动将消息分发到这些队列。如果地址 未 配置为恢复,且还没有绑定到队列,则代理会丢弃发送到该地址的消息。
当您配置被动地址时,代理会创建一个类型的队列的内部实例,称为 环队列。环队列是存放指定、固定消息数量的特殊队列。队列到达指定大小后,到达队列的下一消息会强制从队列中最旧的消息。当您配置被动地址时,您可以间接指定内部环队列的大小。默认情况下,内部队列使用 多播路由
类型。
retroactive 地址使用的内部环队列通过管理 API 公开。您可以检查指标并执行其他常见管理操作,如清空队列。环队列还对地址的总内存用量贡献,这会影响消息分页等行为。
以下步骤演示了如何将地址配置为被动。
流程
-
打开 &
lt;broker_instance_dir> /etc/broker.xml
配置文件。 为
address-setting
元素中的retroactive-message-count
参数指定一个值。您指定的值定义了代理要保留的信息数量。例如:<configuration> <core> ... <address-settings> <address-setting match="orders"> <retroactive-message-count>100</retroactive-message-count> </address-setting> </address-settings> ... </core> </configuration>
注意您可以在代理运行时更新
retroactive-message-count
的值,在broker.xml
配置文件或管理 API 中。但是,如果您 减少 这个值,则需要一个额外的步骤,因为恢复地址通过环队列实施。减少ring-size
参数的 ring 队列不会自动从队列中删除消息,以达到新的ring-size
值。这个行为可防止意外的消息丢失。在这种情况下,您需要使用管理 API 手动减少环队列中的消息数量。
其他资源
- 有关环队列的更多信息,请参阅 第 4.19 节 “配置环队列”。