附录 B. 地址设置配置元素

address-full-policy

决定在配置了 max-size-bytes 的地址满时会发生什么情况。可用的策略有：

PAGE ：发送到完整地址的消息将传到磁盘。

DROP ：发送到完整地址的消息将被静默丢弃。

FAIL ：发送给完整地址的消息将被丢弃，信息制作者将收到异常。

BLOCK ：当消息制作者尝试并发送任何其他消息时，他们将会阻止消息制作者。

auto-create-addresses

客户端发送消息时是否自动创建地址，或尝试使用映射到没有队列的地址的队列中的消息。默认值为 true。

auto-create-dead-letter-resources

指定代理是否自动创建一个死信地址和队列来接收未传送的信息。默认值为 false。

如果参数设为 true，代理会自动创建一个 <address> 元素来定义死信地址和关联的死信队列。自动创建的 <address> 元素的名称与您为 <dead-letter-address> 指定的名称值匹配。

auto-create-jms-queues

已弃用：改为使用 auto-create-queues。确定在 JMS 制作者或消费者尝试使用此类队列时，此代理是否应自动创建与地址设置匹配的 JMS 队列。默认值为 false。

auto-create-jms-topics

已弃用：改为使用 auto-create-queues。确定在 JMS 制作者或消费者尝试使用此类队列时，此代理是否应自动创建与地址设置匹配的 JMS 主题。默认值为 false。

auto-create-queues

客户端发送消息时是否自动创建队列，还是尝试使用来自队列的消息。默认值为 true。

auto-delete-addresses

当代理不再有队列时，是否删除自动创建的地址。默认值为 true。

auto-delete-jms-queues

已弃用：改为使用 auto-delete-queues。决定 AMQ Broker 是否应该在没有消费者且没有消息时自动删除自动创建的 JMS 队列。默认值为 false。

auto-delete-jms-topics

已弃用：改为使用 auto-delete-queues。决定 AMQ Broker 是否应该在没有消费者且没有消息时自动删除自动创建的 JMS 主题。默认值为 false。

auto-delete-queues

当队列没有消费者且没有消息时，是否要删除自动创建的队列。默认值为 true。

config-delete-addresses

重新载入配置文件时，此设置指定了如何处理从 配置文件中删除的地址（及其队列）。您可以指定以下值：

config-delete-queues

重新载入配置文件时，此设置指定了如何处理从配置文件中删除的队列。您可以指定以下值：

dead-letter-address

代理将死信息发送到的地址。

dead-letter-queue-prefix

代理应用到自动创建的死信队列名称的前缀。默认值为 DLQ。

dead-letter-queue-suffix

代理应用到自动创建的死信队列的后缀。未定义默认值（即代理不应用后缀）。

default-address-routing-type

自动创建地址中使用的 routing-type。默认值为 MULTICAST。

default-max-consumers

此队列中任意时间允许的最大消费者数量。默认值为 200。

default-purge-on-no-consumers

是否在没有消费者的情况下清除队列的内容。默认值为 false。

default-queue-routing-type

自动创建的队列中使用的 routing-type。默认值为 MULTICAST。

enable-metrics

指定配置的指标插件（如 Prometheus 插件）是收集匹配地址的指标或地址 集。默认值为 true。

expiry-address

将接收过期邮件的地址。

expiry-delay

定义将使用毫秒的过期时间（以毫秒为单位），用于使用默认到期时间的消息。默认值为 -1，即没有过期时间。

last-value-queue

队列是否只使用最后一个值。默认值为 false。

management-browse-page-size

管理资源可以浏览的消息数。默认值为 200。

max-delivery-attempts

在发送到死信地址之前尝试发送邮件的次数。默认值为 10。

max-redelivery-delay

redelivery-delay 的最大值，以毫秒为单位。

max-size-bytes

这个地址的最大内存大小，以字节为单位指定。当 address-full-policy 为 PAGING、BLOCK 或 FAIL 时使用，这个值使用字节表示法指定，如 "K"、"Mb" 和 "GB"。默认值为 -1，它表示无限字节。此参数用于通过限制特定地址空间消耗的内存量来保护代理内存。此设置不表示当前存储在代理地址空间中的客户端发送的总字节数。这是对代理内存使用率的估算。这个值可能会根据运行时条件和某些工作负载而有所不同。建议您为每个地址空间分配最大内存量。在典型的工作负载下，代理需要大约 150% 到 200% 的内存中过期消息的有效负载大小。

max-size-bytes-reject-threshold

address-full-policy 为 BLOCK 时使用。代理开始拒绝信息之前地址的最大大小，以字节为单位。与 max-size-bytes 相结合，仅适用于 AMQP 协议。默认值为 -1，即没有限制。

message-counter-history-day-limit

为此地址保留消息计数器历史记录的天数。默认值为 0。

page-max-cache-size

要在内存中保留的页面文件数，以便在分页导航期间优化 I/O。默认值为 5。

page-size-bytes

以字节为单位的分页大小。也支持 K、Mb 和 GB 等字节表示法。默认值为 10485760 字节，大约为 10.5 MB。

redelivery-delay

重新传送已取消消息前，以毫秒为单位等待的时间。默认值为 0。

redelivery-delay-multiplier

应用到 redelivery-delay 参数的倍数。默认值为 1.0。

redistribution-delay

定义在队列中最后一个消费者关闭后等待几毫秒后再重新分发任何消息所需的时间。默认值为 -1。

send-to-dla-on-no-route

当设置为 true 时，如果无法路由到任何队列，消息将发送到配置的死信地址。默认值为 false。

slow-consumer-check-period

慢速消费者的检查频率（秒数）。默认值为 5。

slow-consumer-policy

决定识别慢速消费者时发生的情况。有效选项为 KILL 或 NOTIFY。KILL 终止消费者的连接，这会影响使用同一连接的任何客户端线程。NOTIFY 向客户端发送 CONSUMER_SLOW 管理通知。默认值为 NOTIFY。

slow-consumer-threshold

在消费者被视为缓慢之前允许的最小消息消耗率。以消息/秒为单位计算.默认值为 -1，这个值没有绑定。