ApsaraMQ for RabbitMQ：死信Exchange

控制台

您可以在雲訊息佇列 RabbitMQ 版控制台建立Queue時，為其配置死信Exchange。

1. 登入雲訊息佇列 RabbitMQ 版控制台。

2. 在概览頁面的资源分布地區，選擇地區。

3. 在实例列表頁面，單擊目標執行個體名稱。

4. 在左側導覽列，單擊Queue 列表。

5. 在Queue 列表頁面，在当前 Vhost右側的切换下拉式清單中，選擇Vhost，單擊创建 Queue。

6. 在创建 Queue面板，配置以下參數，然後單擊確定。

   參數	描述	說明
   Queue 名称	Queue的名稱	只能包含字母、數字、短劃線（-）、底線（_）、半形句號（.）、井號（#）、正斜線（/）、at符號（@）。 長度限制在1~255字元。 建立後無法修改，只能刪除重建。 以amq.開頭的為保留欄位，因此不能使用。例如：amq.test。
   Auto Delete	最後一個Consumer取消訂閱後，Queue是否自動刪除。	true：在訂閱該Queue訊息的最後一個Consumer取消訂閱該Queue的訊息後，自動刪除該Queue。 false：在訂閱該Queue訊息的最後一個Consumer取消訂閱該Queue的訊息後，不自動刪除該Queue。
   重试策略	配置Queue重試策略。各執行個體策略參數取值，請參見執行個體重試策略參數說明。	是否繼承執行個體配置： 是：繼承執行個體預設配置。 否：自訂配置。 最大投遞次數：系統將一條訊息嘗試投遞給消費者的最大次數限制。單位：次。 消費逾時時間：消費者在接收和處理訊息時允許的最大時間限制。單位：秒。
   死信策略	Queue的參數設定，可用於設定死信Exchange、死信Routing Key和訊息存活時間。	DeadLetterExchange：指定死信訊息發送的目標Exchange。 DeadLetterRoutingKey：指定死信訊息的Routing Key，即死信Exchange會將訊息發送至匹配該死信Routing Key所對應的Queue。 MessageTTL：訊息存活時間，單位毫秒（ms）。在指定時間內未被成功消費的訊息會變成死信訊息，該訊息將會被發送到死信Exchange。更多資訊，請參見訊息存活時間。

API

您可以在通過API建立Queue時，為其配置死信Exchange。更多資訊，請參見CreateQueue。

用戶端

您可以在雲訊息佇列 RabbitMQ 版用戶端聲明Queue時，為其配置死信Exchange。

通過x-dead-letter-exchange和x-dead-letter-routing-key設定死信訊息要發送的Exchange以及死信訊息的Routing Key。

例如，聲明一個名稱為some.exchange.name、類型為direct的Exchange，使用 x-dead-letter-exchange將該Exchange設定為死信Exchange，使用x-dead-letter-routing-key將死信訊息的Routing Key設定為demo-routing-key。

Java範例程式碼如下：

channel.exchangeDeclare("some.exchange.name", "direct");
Map<String, Object> args = new HashMap<String, Object>();
arguments.put("x-dead-letter-exchange", "some.exchange.name");
arguments.put("x-dead-letter-routing-key", "demo-routing-key");
channel.queueDeclare("MyQueue", false, false, false, arguments);