目录
- 1、概述
- 2、代码演示
- 1、生产者
- 2、消费者(消费死信队列消息)
- 3、消费者(消费生产者消息)
- 3.1、队列达到最大长度
- 3.2、消息被拒
- 3.3、消息 TTL 过期
- 4、源码地址
1、概述
概述:
producer 将消息投递到 broker 或者直接到 queue 里了,consumer 从 queue 取出消息进行消费,但某些时候由于特定的原因导致 queue 中的某些消息无法被消费,这样的消息如果没有后续的处理,就变成了死信,所有的死信就组成了死信队列。
应用场景: 为了保证订单业务的消息数据不丢失,需要使用到 RabbitMQ 的死信队列机制,当消息消费发生异常时,将消息投入死信队列中。
产生原因:
- 消息 TTL 过期(单位)
- 队列达到最大长度(队列满了,无法再添加数据到 mq 中)
- 消息被拒绝(basic.reject 或 basic.nack)并且 requeue=false.
死信队列框架图:
2、代码演示
步骤:
- 生产者: 正常发送消息;
- 消费者(消费死信队列消息): 正常声明交换机、队列,为了让消息进入死信队列,需要将正常交换机与死信交换机进行绑定,这样消息在过期、拒接接收、 队列在达到最大长度时,消息就可以进入到死信队列;核心代码:
arguments.put(" x-dead-letter-exchange","dlx.exchange");
- 消费者(消费生产者消息): 声明死信交换机、队列,从死信队列中获取数据;
代码参考: https://gitee.com/lhzlx/rabbit-simple-demo.git
1、生产者
代码路径:
lhz.dlx
类:Producer
public class Producer {
/**
* 设置队列名称
*/
private static final String NORMAL_ROUTING_KEY = "normal";
private static final String NORMAL_EXCHANGE = "normal_exchange";
public static void main(String[] args) throws Exception {
// 获取Channel
Channel channel = RabbitMqUtils.getChannel();
channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
AMQP.BasicProperties properties = null;
for (int i = 1; i < 11; i++) {
String message = "info" + i;
channel.basicPublish(NORMAL_EXCHANGE, NORMAL_ROUTING_KEY, properties, message.getBytes());
}
System.out.println("消息发送完毕");
}
}
2、消费者(消费死信队列消息)
为了让进入到死信队列
中的消息,不会一直累计,通过一个特殊的消费者
,将死信队列
中的消息进行消费;
代码路径:
lhz.dlx
类:Consumer02
public class Consumer02 {
/**
* 设置队列名称
*/
private static final String ROUTING_KEY = "dlx";
private static final String DEAD_EXCHANGE = "dead_exchange";
public static void main(String[] args) throws Exception {
// 获取Channel
Channel channel = RabbitMqUtils.getChannel();
channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);
// 声明死信队列
String deadQueue = "dead-queue";
channel.queueDeclare(deadQueue, false, false, false, null);
channel.queueBind(deadQueue, DEAD_EXCHANGE, ROUTING_KEY);
System.out.println("Consumer02等待接收死信队列消息.....");
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
System.out.println("Consumer02接收死信队列的消息" + message);
};
channel.basicConsume(deadQueue, true, deliverCallback, consumerTag -> {
});
}
}
3、消费者(消费生产者消息)
3.1、队列达到最大长度
步骤:
- 删除之前模拟TTL的normal-queue、dead-queue;
-
Consumer01
,设置max-length参数,启动之后关闭该消费者,模拟其接收不到消息; - 正常启动生产者发送消息;
- 消息进入死信队列后,启动
Consumer02
,它消费死信队列里面的消息; - 预期结果:
生产者代码:
与
1、生产者
中代码一致;
消费者代码:
代码路径:
lhz.dlx
类:Consumer01
public class Consumer01 {
// 路由
private static final String ROUTING_KEY = "dlx";
private static final String NORMAL_ROUTING_KEY = "normal";
//普通交换机名称
private static final String NORMAL_EXCHANGE = "normal_exchange";
//死信交换机名称
private static final String DEAD_EXCHANGE = "dead_exchange";
public static void main(String[] args) throws Exception {
// 获取Channel
Channel channel = RabbitMqUtils.getChannel();
// 声明死信和普通交换机 类型为 direct
channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);
// 声明死信队列
String deadQueue = "dead-queue";
channel.queueDeclare(deadQueue, false, false, false, null);
// 死信队列绑定死信交换机与 routingkey
channel.queueBind(deadQueue, DEAD_EXCHANGE, ROUTING_KEY);
//正常队列绑定死信队列信息
Map<String, Object> params = new HashMap<>();
//正常队列设置死信交换机 参数 key是固定值
params.put("x-dead-letter-exchange", DEAD_EXCHANGE);
//正常队列设置死信 routing-key 参数 key是固定值
params.put("x-dead-letter-routing-key", ROUTING_KEY);
// TODO 如果是演示`队列达到最大长度`的情况,需要设置最大队列数量
params.put("x-max-length", 6);
// 声明正常队列
String normalQueue = "normal-queue";
channel.queueDeclare(normalQueue, false, false, false, params);
channel.queueBind(normalQueue, NORMAL_EXCHANGE, NORMAL_ROUTING_KEY);
System.out.println("Consumer01等待接收消息.....");
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
System.out.println("Consumer01接收到消息" + message);
channel.basicAck(delivery.getEnvelope().getDeliveryTag(), false);
};
channel.basicConsume(normalQueue, false, deliverCallback, consumerTag -> {
});
}
}
3.2、消息被拒
步骤:
- 删除之前模拟时产生的normal-queue、dead-queue;
-
Consumer01
,设置为消息手动确认并且拒绝接收某条消息,然后启动(不进行关闭
); - 当被拒绝的消息进入死信队列后,启动
Consumer02
它消费死信队列里面的消息; - 预期结果:
生产者代码:
与
1、生产者
中代码一致;
消费者代码:
代码路径:
lhz.dlx
类:Consumer01
public class Consumer01 {
// 路由
private static final String ROUTING_KEY = "dlx";
private static final String NORMAL_ROUTING_KEY = "normal";
//普通交换机名称
private static final String NORMAL_EXCHANGE = "normal_exchange";
//死信交换机名称
private static final String DEAD_EXCHANGE = "dead_exchange";
public static void main(String[] args) throws Exception {
// 获取Channel
Channel channel = RabbitMqUtils.getChannel();
// 声明死信和普通交换机 类型为 direct
channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);
// 声明死信队列
String deadQueue = "dead-queue";
channel.queueDeclare(deadQueue, false, false, false, null);
// 死信队列绑定死信交换机与 routingkey
channel.queueBind(deadQueue, DEAD_EXCHANGE, ROUTING_KEY);
//正常队列绑定死信队列信息
Map<String, Object> params = new HashMap<>();
//正常队列设置死信交换机 参数 key是固定值
params.put("x-dead-letter-exchange", DEAD_EXCHANGE);
//正常队列设置死信 routing-key 参数 key是固定值
params.put("x-dead-letter-routing-key", ROUTING_KEY);
// 声明正常队列
String normalQueue = "normal-queue";
channel.queueDeclare(normalQueue, false, false, false, params);
channel.queueBind(normalQueue, NORMAL_EXCHANGE, NORMAL_ROUTING_KEY);
System.out.println("Consumer01等待接收消息.....");
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
// TODO 模拟拒绝接收进入死信队列
if (message.equals("info5")) {
System.out.println("Consumer01接收到消息" + message + "并拒绝签收该消息");
//requeue设置为 false 代表拒绝重新入队 该队列如果配置了死信交换机将发送到死信队列中
channel.basicReject(delivery.getEnvelope().getDeliveryTag(), false);
} else {
System.out.println("Consumer01接收到消息" + message);
channel.basicAck(delivery.getEnvelope().getDeliveryTag(), false);
}
};
channel.basicConsume(normalQueue, false, deliverCallback, consumerTag -> {
});
}
}
3.3、消息 TTL 过期
步骤:
- 删除之前模拟时产生的normal-queue、dead-queue;
- 先
Consumer01
启动之后关闭该消费者 模拟其接收不到消息; - 启动生产者发送消息(设置了10STTL过期时间);
- 观察rabbitmq控制台,消息进入死信队列后,启动
Consumer02
消费死信队列里面的消息; - 预期结果:
生产者代码:
// 在《1、生产者》基础上加上以下代码:
properties =new AMQP.BasicProperties().builder().expiration("10000").build();
消费者代码:
代码路径:
lhz.dlx
类:
Producer
public class Consumer01 {
// 路由
private static final String ROUTING_KEY = "dlx";
private static final String NORMAL_ROUTING_KEY = "normal";
//普通交换机名称
private static final String NORMAL_EXCHANGE = "normal_exchange";
//死信交换机名称
private static final String DEAD_EXCHANGE = "dead_exchange";
public static void main(String[] args) throws Exception {
// 获取Channel
Channel channel = RabbitMqUtils.getChannel();
// 声明死信和普通交换机 类型为 direct
channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);
// 声明死信队列
String deadQueue = "dead-queue";
channel.queueDeclare(deadQueue, false, false, false, null);
// 死信队列绑定死信交换机与 routingkey
channel.queueBind(deadQueue, DEAD_EXCHANGE, ROUTING_KEY);
//正常队列绑定死信队列信息
Map<String, Object> params = new HashMap<>();
//正常队列设置死信交换机 参数 key是固定值
params.put("x-dead-letter-exchange", DEAD_EXCHANGE);
//正常队列设置死信 routing-key 参数 key是固定值
params.put("x-dead-letter-routing-key", ROUTING_KEY);
// 声明正常队列
String normalQueue = "normal-queue";
channel.queueDeclare(normalQueue, false, false, false, params);
channel.queueBind(normalQueue, NORMAL_EXCHANGE, NORMAL_ROUTING_KEY);
System.out.println("Consumer01等待接收消息.....");
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), StandardCharsets.UTF_8);
System.out.println("Consumer01接收到消息" + message);
channel.basicAck(delivery.getEnvelope().getDeliveryTag(), false);
};
channel.basicConsume(normalQueue, false, deliverCallback, consumerTag -> {
});
}
}