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 ...>

   match

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

   dead-letter-address

   死信地址的名称。在本例中，代理将未发送的消息从队列 exampleQueue 移到死信地址 DLA。

   max-delivery-attempts

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

3. 在 addresses 部分中，为死信地址 DLA 添加一个 address 元素。要将死信队列与死信地址关联，请为 队列 指定 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，代理会自动创建定义死信 地址和 关联的死信队列的 <address> 元素。自动创建的 < address> 元素的名称与 您为 < dead-letter-address> 指定的 name 值匹配。

   代理在自动创建的 <address> 元素 中定义的 死信队列具有 multicast 路由类型。默认情况下，代理将死信队列命名为死信队列，以匹配未 传输消息的原始地址，如库存。

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

   dead-letter-queue-prefix

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

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

   dead-letter-queue-suffix

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