死信Exchange

控制台

您可以在云消息队列 RabbitMQ 版控制台创建Queue时，为其配置死信Exchange。

1. 登录云消息队列 RabbitMQ 版控制台。

2. 在概览页面的资源分布区域，选择地域。

3. 在实例列表页面，单击目标实例名称。

4. 在左侧导航栏，单击Queue 列表。

5. 在Queue 列表页面，在当前 Vhost右侧的切换下拉列表中，选择Vhost，单击创建 Queue。

6. 在创建 Queue面板，在Queue 名称文本框输入Queue的名称，选择是否为Auto Delete类型，单击高级选项，设置Queue的参数，然后单击确定。

   参数	描述	说明
   Queue 名称	Queue的名称	只能包含字母、数字、短划线（-）、下划线（_）、半角句号（.）、井号（#）、正斜线（/）、at符号（@）。 长度限制在1~255字符。 创建后无法修改，只能删除重建。 以amq.开头的为保留字段，因此不能使用。例如：amq.test。
   Auto Delete	最后一个Consumer取消订阅后，Queue是否自动删除。	true：在订阅该Queue消息的最后一个Consumer取消订阅该Queue的消息后，自动删除该Queue。 false：在订阅该Queue消息的最后一个Consumer取消订阅该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);