4.13. 将未发送的消息移到死信地址

流程

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

   Copy to Clipboard Toggle word wrap

   match

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

   dead-letter-address

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

   max-delivery-attempts

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

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

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

   Copy to Clipboard Toggle word wrap

流程

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   auto-create-dead-letter-resources

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

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

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

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

   dead-letter-queue-prefix

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

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

   dead-letter-queue-suffix

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