4.13. 将未接收的消息移动到死信地址

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 在与队列名称匹配的 < address-setting > 元素中，为死信地址名称设置值以及传输尝试的最大数量。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   匹配

   代理在此 address-setting 部分中应用配置的地址。您可以为 < address-setting > 元素的 match 属性指定一个通配符表达式。如果要将 < address-setting > 元素中配置的死信>元素 与一组 匹配的地址关联，可使用通配符表达式。

   dead-letter-address

   死信地址的名称。在本例中，代理将来自队列 示例Queue 的消息移到 dead letter 地址 DLA。

   max-delivery-attempts

   代理在将未发送的消息移动到配置的死信地址之前，代理进行的最大交付尝试数。在本例中，代理会在 3 次失败发送尝试后将未发送的消息移到死信地址。默认值为 10。如果您希望代理进行无限次重新发送尝试，请指定 -1 值。

3. 在 address 部分中，为死信 地址 DLA 添加地址元素。要将死信队列与死信地址关联，请为 队列 指定 name 值。例如：

   <configuration ...>
      <core ...>
         ...
         <addresses>
            <address name="DLA">
               <anycast>
                  <queue name="DLQ" />
               </anycast>
            </address>
         ...
         </addresses>
      </core>
   </configuration>

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 找到您之前添加的 &lt ;address-setting > 元素，以定义匹配队列或一组队列的死信地址。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

3. 在 <address-setting > 元素中，添加配置项来指示代理自动创建死信资源（即地址和队列），以及如何命名这些资源。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
               <auto-create-dead-letter-resources>true</auto-create-dead-letter-resources>
               <dead-letter-queue-prefix>DLQ.</dead-letter-queue-prefix>
               <dead-letter-queue-suffix></dead-letter-queue-suffix>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   auto-create-dead-letter-resources

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

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

   代理在自动创建的 <address> 元素 中定义的 死信队列具有 多播路由 类型。默认情况下，代理将死信队列名称以匹配未发送的消息的原始地址，如 stocks。

   代理还会为使用 _AMQ_ORIG_ADDRESS 属性的死信队列定义过滤器。此过滤器确保死信队列仅接收发送到对应原始地址的消息。

   dead-letter-queue-prefix

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

   当您定义前缀值或保留默认值时，死信队列的名称是前缀的串联和原始地址，如 DLQ.stocks。

   dead-letter-queue-suffix

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