7. RabbitMQ 消息队列——延时队列(Spring Boot + 安装message_exchange"延迟插件" 的详细配置说明)的详细讲解
@
目录7. RabbitMQ 消息队列——延时队列(Spring Boot + 安装message_exchange"延迟插件" 的详细配置说明)的详细讲解1. RabbitMQ 延时队列概述2. RabbitMQ 中的 TTL3. RabbitMQ 整合 Spring Boot3.1 Spring Boot 当中搭建配置 RabbitMQ 的 队列 TTL(延时队列)null3.2 延时队列优化3.3 Rabbitmq 插件实现延迟队列4. 补充：Docker 容器当中安装 message_exchange"延迟插件" 的详细步骤5. 最后：
1. RabbitMQ 延时队列概述
延时队列,队列内部是有序的，最重要的特性就体现在它的延时属性上，延时队列中的元素是希望 在指定时间到了以后或之前取出和处理，简单来说，延时队列就是用来存放需要在指定时间被处理的 元素的队列。
延时队列的应用场景：
场景：有一个订单，15 分钟内如果不支付，就把该订单设置为交易关闭，那么就不能再进行支付了，这类实现延迟任务的场景就可以采用延时队列的方式来实现，当然除了延时队列，还可以采用其它的方式——> 定时任务的方式。
订单在十分钟之内未支付则自动取消。
新创建的店铺，如果在十天内都没有上传过商品，则自动发送消息提醒。
用户注册后，如果三天内没有登陆则进行短信提醒。
用户发起退款，如果三天内没有得到处理则通知相关运营人员。
预定会议后，需要在预定的时间点前 10 分钟，通知各个参会人员参加会议。
这些场景都有一个特点，需要在某个事件发生之后或者之前的指定时间点完成某一项任务，如： 发生订单生成事件，在十分钟之后检查该订单支付状态，然后将未支付的订单进行关闭；看起来似乎 使用定时任务，一直轮询数据，每秒查一次，取出需要被处理的数据，然后处理不就完事了吗？如果 数据量比较少，确实可以这样做，比如：对于“如果账单一周内未支付则进行自动结算”这样的需求， 如果对于时间不是严格限制，而是宽松意义上的一周，那么每天晚上跑个定时任务检查一下所有未支 付的账单，确实也是一个可行的方案。但对于数据量比较大，并且时效性较强的场景，如：“订单十 分钟内未支付则关闭“，短期内未支付的订单数据可能会有很多，活动期间甚至会达到百万甚至千万 级别，对这么庞大的数据量仍旧使用轮询的方式显然是不可取的，很可能在一秒内无法完成所有订单 的检查，同时会给数据库带来很大压力，无法满足业务要求而且性能低下。
2. RabbitMQ 中的 TTL
TTL 是什么呢？TTL 是 RabbitMQ 中一个消息或者队列的属性，表明一条消息或者队列中的所有消息的最大存活时间。
单位是毫秒。换句话说，如果一条消息设置了 TTL 属性或者进入了设置 TTL 属性的队列，那么这条消息如果在 TTL 设置的时间内没有被消费，则会成为 “死信 ” 。如果同时配置了队列的 TTL 和消息的 TTL ，那么较小的那个值将会被使用，有两种方式设置了 TTL 。
消息设置 TTL：
另一种方式便是针对每条消息设置 TTL
队列设置 TTL：
第一种是在创建队列的时候设置队列的 “x-message-ttl ” 属性。
延时队列 和 死信队列：
如果设置了队列的 TTL 属性，那么一旦消息过期，就会被队列丢弃(如果配置了死信队列被丢到死信队 列中)，而第二种方式，消息即使过期，也不一定会被马上丢弃，因为消息是否过期是在即将投递到消费者 之前判定的，如果当前队列有严重的消息积压情况，则已过期的消息也许还能存活较长时间；另外，还需 要注意的一点是，如果不设置 TTL，表示消息永远不会过期，如果将 TTL 设置为 0，则表示除非此时可以 直接投递该消息到消费者，否则该消息将会被丢弃。
上一篇我们介绍了死信队列，刚刚又介绍了 TTL，至此利用 RabbitMQ 实现延时队列的两大要素已 经集齐，接下来只需要将它们进行融合，再加入一点点调味料，延时队列就可以新鲜出炉了。想想看，延 时队列，不就是想要消息延迟多久被处理吗，TTL 则刚好能让消息在延迟多久之后成为死信，另一方面， 成为死信的消息都会被投递到死信队列里，这样只需要消费者一直消费死信队列里的消息就完事了，因为 里面的消息都是希望被立即处理的消息。
3. RabbitMQ 整合 Spring Boot
1. 创建项目
添加相关依赖，在 pom.xml 文件当中
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
在 resources/创建一个 application.properties 文件当中(当然也可以使用 yaml 配置文件)，配置相关的配置文件
spring.rabbitmq.host=192.168.76.156
spring.rabbitmq.port=5672
spring.rabbitmq.username=admin
spring.rabbitmq.password=123
添加 Swagger 配置类
package com.rainbowsea.rabbitmq.springbootrabbitmq.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket webApiConfig() {
return new Docket(DocumentationType.SWAGGER_2)
.groupName("webApi")
.apiInfo(webApiInfo())
.select()
.build();
}
private ApiInfo webApiInfo() {
return new ApiInfoBuilder()
.title("rabbitmq 接口文档")
.description("本文档描述了 rabbitmq 微服务接口定义")
.version("1.0")
.contact(new Contact("enjoy6288", "http://rainbowsea.com", "3339966@qq.com"))
.build();
}
}
3.1 Spring Boot 当中搭建配置 RabbitMQ 的 队列 TTL(延时队列)
代码架构图：
创建两个队列 QA 和 QB，两者队列 TTL 分别设置为 10S 和 40S，然后在创建一个交换机 X 和死信交 换机 Y，它们的类型都是 direct，创建一个死信队列 QD，它们的绑定关系如下：
1. 创建文件类代码（该代码就是用于配置 RabbitMQ 当中的交换机和队列的信息配置的），作为一个配置类存在的 。
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration // 标注是一个配置类，加载到 IOC 容器当中
public class TtlQueueConfig {
// 普通交换机的名称
public static final String X_EXCHANGE = "X";
// 声明 XExchange 别名；会注入到 IOC 容器当中 普通交换机的
@Bean(value = "xExchange")
public DirectExchange xExchange() {
return new DirectExchange(X_EXCHANGE);
}
}
package com.rainbowsea.rabbitmq.springbootrabbitmq.config;
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration // 标注是一个配置类，加载到 IOC 容器当中
public class TtlQueueConfig {
// 普通交换机的名称
public static final String X_EXCHANGE = "X";
// 死信队列的名称
public static final String DEAD_LETTER_QUEUE = "QD";
// 死信交换机的名称
public static final String Y_DEAD_LETTER_EXCHANGE = "Y";
// 普通队列的名称
public static final String QUEUE_A = "QA";
public static final String QUEUE_B = "QB";
// 声明普通队列 TTL 为 10s
@Bean("queueA")
public Queue queueA() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 10000);
return QueueBuilder.durable(QUEUE_A).withArguments(arguments).build();
}
// 声明普通队列 TTL 为 40s
@Bean("queueB")
public Queue queueB() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 40000);
return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
}
}
// 声明死信队列
@Bean("queueD")
public Queue queueD() {
// 不带参数，就不需要 .withArguments(arguments)
//return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
return QueueBuilder.durable(DEAD_LETTER_QUEUE).build();
}
// 绑定
/**
* 注意：这里的 public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
* @Qualifier("xExchange") DirectExchange xExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "xExchange")，@Bean("queueA") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "xExchange")
* public DirectExchange xExchange() {
* @Bean("queueA") public Queue queueA() {
*/
@Bean
public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XA"
// 表示将 队列 queueA 与 xExchange 交换机，通过 routingKey 为 "XA" 进行一个绑定
return BindingBuilder.bind(queueA).to(xExchange).with("XA");
}
完整配置代码如下：
package com.rainbowsea.rabbitmq.springbootrabbitmq.config;
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration // 标注是一个配置类，加载到 IOC 容器当中
public class TtlQueueConfig {
// 普通交换机的名称
public static final String X_EXCHANGE = "X";
// 死信队列的名称
public static final String DEAD_LETTER_QUEUE = "QD";
// 死信交换机的名称
public static final String Y_DEAD_LETTER_EXCHANGE = "Y";
// 普通队列的名称
public static final String QUEUE_A = "QA";
public static final String QUEUE_B = "QB";
// 声明 XExchange 别名；会注入到 IOC 容器当中 普通交换机的
@Bean(value = "xExchange")
public DirectExchange xExchange() {
return new DirectExchange(X_EXCHANGE);
}
// 声明 yExchange 别名；会注入到 IOC 容器当中 普通交换机的
@Bean(value = "yExchange")
public DirectExchange yExchange() {
return new DirectExchange(Y_DEAD_LETTER_EXCHANGE);
}
// 声明普通队列 TTL 为 10s
@Bean("queueA")
public Queue queueA() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 10000);
return QueueBuilder.durable(QUEUE_A).withArguments(arguments).build();
}
// 声明普通队列 TTL 为 40s
@Bean("queueB")
public Queue queueB() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 40000);
return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
}
// 声明死信队列
@Bean("queueD")
public Queue queueD() {
// 不带参数，就不需要 .withArguments(arguments)
//return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
return QueueBuilder.durable(DEAD_LETTER_QUEUE).build();
}
// 绑定
/**
* 注意：这里的 public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
* @Qualifier("xExchange") DirectExchange xExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "xExchange")，@Bean("queueA") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "xExchange")
* public DirectExchange xExchange() {
* @Bean("queueA") public Queue queueA() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XA"
// 表示将 队列 queueA 与 xExchange 交换机，通过 routingKey 为 "XA" 进行一个绑定
return BindingBuilder.bind(queueA).to(xExchange).with("XA");
}
// 绑定
/**
* 注意：这里的 public Binding queueBBindingX(@Qualifier("queueB") Queue queueB,
* @Qualifier("xExchange") DirectExchange xExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "xExchange")，@Bean("queueB") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "xExchange")
* public DirectExchange xExchange() {
* @Bean("queueB") public Queue queueB() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueBBindingX(@Qualifier("queueB") Queue queueB,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XB"
// 表示将 队列 queueB 与 xExchange 交换机，通过 routingKey 为 "XB" 进行一个绑定
return BindingBuilder.bind(queueB).to(xExchange).with("XB");
}
// 绑定
/**
* 注意：这里的 public Binding queueDBindingX(@Qualifier("queueD") Queue queueD,
* @Qualifier("yExchange") DirectExchange yExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "yExchange")，@Bean("queueD") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "yExchange")
* public DirectExchange yExchange() {
* @Bean("queueD")
* public Queue queueD() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueDBindingX(@Qualifier("queueD") Queue queueD,
@Qualifier("yExchange") DirectExchange yExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"YD"
// 表示将 队列 queueD 与 yExchange 交换机，通过 routingKey 为 "YD" 进行一个绑定
return BindingBuilder.bind(queueD).to(yExchange).with("YD");
}
}
生产者——》发送消息的代码：
package com.rainbowsea.rabbitmq.springbootrabbitmq.controller;
import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.Date;
/**
* 生产者：发送延时消息
* http://localhost:8080/ttl/sendMsg/嘻嘻嘻
*/
@RestController
@RequestMapping("/ttl")
@Slf4j
public class SendMsgController {
@Resource // 注入到 IOC 容器当中
private RabbitTemplate rabbitTemplate;
@GetMapping("/sendMsg/{message}")
public void sendMsg(@PathVariable String message) {
log.info("当前时间:{},发送一条消息给两个 TTL 队列:{}", new Date().toString(), message);
rabbitTemplate.convertAndSend("X","XA","消息来自ttl为 10s的队列" + message);
rabbitTemplate.convertAndSend("X","XB","消息来自ttl为 40s的队列" + message);
}
}
消费者——》消费/读取消息的代码：
package com.rainbowsea.rabbitmq.springbootrabbitmq.consumer;
import com.rabbitmq.client.Channel;
import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.io.IOException;
import java.util.Date;
/**
* 消费者(消费/读取消息)
*/
@Slf4j
@Component // 当 IOC 容器读取到
public class DeadLetterQueueConsumer {
@RabbitListener(queues = "QD")
public void receiveD(Message message, Channel channel) {
String msg = new String(message.getBody());
log.info("当前时间:{},收到死信队列的消息:{}", new Date().toString(), msg);
}
}
运行效果：
该延时队列存在的问题：
第一条消息在 10 S 后变成了死信消息，然后被消费者消费/读取掉了，第二条消息在 40S 之后变成了死信消息，然后被消费掉，这样一个延时队列就被打造完成了。
不过，该延时队列存在一个问题：
如果这样使用的话，岂不是每增加一个新的时间需求，就要新增一个队列。 这里只有 10S 和 40S 两个时间选项，如果需要一个小时后处理，那么就需要增加 TTL 为一个小时的队列，如果是预定会议室，然后提前通知这样的场景，岂不是要增加无数个队列才能满足需求。
3.2 延时队列优化
优化思路： 就是把延时时间，交给发送消息的生产者上决定，而不是写死在队列当中，通过一个无延时队列来处理，生产者上设置的一个延时发送的时间。
在这里新增了一个队列 QC,绑定关系如下，该队列不设置 TTL 时间
特别注意： 这里需要将上面创建了的 交换机，队列删除了，因为 RabbitMQ 消息队列不能将一个已经存在的交换机/队列，的基础上，进行修改，而是只能重新生成 。
在 TtlQueueConfig 配置类上添加上一个，RoutingKey 为 XC ，队列为 QC，对应 死信队列还是 QD 。
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration // 标注是一个配置类，加载到 IOC 容器当中
public class TtlQueueConfig {
// 普通交换机的名称
public static final String X_EXCHANGE = "X";
// 死信队列的名称
public static final String DEAD_LETTER_QUEUE = "QD";
// 死信交换机的名称
public static final String Y_DEAD_LETTER_EXCHANGE = "Y";
// 普通队列的名称
public static final String QUEUE_A = "QA";
public static final String QUEUE_B = "QB";
//普通队列的名称
public static final String QUEUE_C = "QC";
// 声明队列 QC 同时绑定上 (以 RoutingKey 为 XC )QD 死信交换机
@Bean("queueC")
public Queue queueC(){
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 不设置 TTL 时间，也是通过生产者来设置
return QueueBuilder.durable(QUEUE_C).withArguments(arguments).build();
}
// 将声明的队列 QC 绑定到 X 交换机当中
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueBindingX(@Qualifier("queueC") Queue queueC,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XC"
// 表示将 队列 queueC 与 xExchange 交换机，通过 routingKey 为 "XC" 进行一个绑定
return BindingBuilder.bind(queueC).to(xExchange).with("XC");
}
}
完整代码内容：
package com.rainbowsea.rabbitmq.springbootrabbitmq.config;
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration // 标注是一个配置类，加载到 IOC 容器当中
public class TtlQueueConfig {
// 普通交换机的名称
public static final String X_EXCHANGE = "X";
// 死信队列的名称
public static final String DEAD_LETTER_QUEUE = "QD";
// 死信交换机的名称
public static final String Y_DEAD_LETTER_EXCHANGE = "Y";
// 普通队列的名称
public static final String QUEUE_A = "QA";
public static final String QUEUE_B = "QB";
//普通队列的名称
public static final String QUEUE_C = "QC";
// 声明队列 QC 同时绑定上 (以 RoutingKey 为 XC )QD 死信交换机
@Bean("queueC")
public Queue queueC(){
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 不设置 TTL 时间，也是通过生产者来设置
return QueueBuilder.durable(QUEUE_C).withArguments(arguments).build();
}
// 将声明的队列 QC 绑定到 X 交换机当中
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueBindingX(@Qualifier("queueC") Queue queueC,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XC"
// 表示将 队列 queueC 与 xExchange 交换机，通过 routingKey 为 "XC" 进行一个绑定
return BindingBuilder.bind(queueC).to(xExchange).with("XC");
}
// 声明 XExchange 别名；会注入到 IOC 容器当中 普通交换机的
@Bean(value = "xExchange")
public DirectExchange xExchange() {
return new DirectExchange(X_EXCHANGE);
}
// 声明 yExchange 别名；会注入到 IOC 容器当中 普通交换机的
@Bean(value = "yExchange")
public DirectExchange yExchange() {
return new DirectExchange(Y_DEAD_LETTER_EXCHANGE);
}
// 声明普通队列 TTL 为 10s
@Bean("queueA")
public Queue queueA() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 10000);
return QueueBuilder.durable(QUEUE_A).withArguments(arguments).build();
}
// 声明普通队列 TTL 为 40s
@Bean("queueB")
public Queue queueB() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 设置死信交换机 注意这里的参数 x-dead-letter-exchange 是固定的不可
arguments.put("x-dead-letter-exchange", Y_DEAD_LETTER_EXCHANGE);
// 设置死信的 RoutingKey 为 YD ，注意这里的参数 x-dead-letter-routing-key 是固定的不可随便写
arguments.put("x-dead-letter-routing-key", "YD");
// 设置 TTL ，单位是 ms 注意这里的参数 x-message-ttl 是固定的不可随便写
arguments.put("x-message-ttl", 40000);
return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
}
// 声明死信队列
@Bean("queueD")
public Queue queueD() {
// 不带参数，就不需要 .withArguments(arguments)
//return QueueBuilder.durable(QUEUE_B).withArguments(arguments).build();
return QueueBuilder.durable(DEAD_LETTER_QUEUE).build();
}
// 绑定
/**
* 注意：这里的 public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
* @Qualifier("xExchange") DirectExchange xExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "xExchange")，@Bean("queueA") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "xExchange")
* public DirectExchange xExchange() {
* @Bean("queueA") public Queue queueA() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueABindingX(@Qualifier("queueA") Queue queueA,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XA"
// 表示将 队列 queueA 与 xExchange 交换机，通过 routingKey 为 "XA" 进行一个绑定
return BindingBuilder.bind(queueA).to(xExchange).with("XA");
}
// 绑定
/**
* 注意：这里的 public Binding queueBBindingX(@Qualifier("queueB") Queue queueB,
* @Qualifier("xExchange") DirectExchange xExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "xExchange")，@Bean("queueB") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "xExchange")
* public DirectExchange xExchange() {
* @Bean("queueB") public Queue queueB() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueBBindingX(@Qualifier("queueB") Queue queueB,
@Qualifier("xExchange") DirectExchange xExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"XB"
// 表示将 队列 queueB 与 xExchange 交换机，通过 routingKey 为 "XB" 进行一个绑定
return BindingBuilder.bind(queueB).to(xExchange).with("XB");
}
// 绑定
/**
* 注意：这里的 public Binding queueDBindingX(@Qualifier("queueD") Queue queueD,
* @Qualifier("yExchange") DirectExchange yExchange)
*
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier("xExchange") DirectExchange xExchange)
* @Qualifier 参数内的值是，我们上边： @Bean(value = "yExchange")，@Bean("queueD") 注入到 IOC 容器当中的值
* ，必须要是注入到了 IOC容器当中，不然是无法被使用上的，同时注意名称，不要写错了，要保持一致
* @Bean(value = "yExchange")
* public DirectExchange yExchange() {
* @Bean("queueD")
* public Queue queueD() {
*/
@Bean // 绑定也是要注入到 IOC 容器当中的
public Binding queueDBindingX(@Qualifier("queueD") Queue queueD,
@Qualifier("yExchange") DirectExchange yExchange) {
// 第一个参数是 队列名(注入到了IOC容器当中了)，第二个参数是交换机(注入到了IOC容器当中了)
// 第三个蚕食是: 队列名对于绑定交换机之间的交互的 routingKey 信息"YD"
// 表示将 队列 queueD 与 yExchange 交换机，通过 routingKey 为 "YD" 进行一个绑定
return BindingBuilder.bind(queueD).to(yExchange).with("YD");
}
}
生产者——> 发送消息，代码
这里，生产者，指定一个延时时间(TTL)，交给 X 交换机——>以 routingKey = XC 发送给 QC 队列——> 发送给死信交换机——> 以 routingKey = YD 分配给 QD 死信队列——>最后给消费者读取/消费消息。
import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.Date;
/**
* 生产者：发送延时消息
* http://localhost:8080/ttl/sendMsg/嘻嘻嘻
*/
@RestController
@RequestMapping("ttl")
@Slf4j
public class SendMsgController {
@Resource // 注入到 IOC 容器当中
private RabbitTemplate rabbitTemplate;
@GetMapping("/sendExpirationMsg/{message}/{ttlTime}")
public void sendMsg(@PathVariable String message,
@PathVariable String ttlTime) {
log.info("当前时间:{},发送一条时长{}毫秒 TTL 消息给队列QC:{}", new Date().toString(), ttlTime, message);
rabbitTemplate.convertAndSend("X", "XC", message, msg -> {
// 发送消息的时候，延时时长
msg.getMessageProperties().setExpiration(ttlTime);
return msg;
});
log.info("当前时间：{},发送一条时长{}毫秒 TTL 信息给队列 C:{}", new Date(), ttlTime, message);
}
}
测试效果：
浏览器发送请求：
http://localhost:8080/ttl/sendExpirationMsg/你好1/20000
http://localhost:8080/ttl/sendExpirationMsg/你好2/2000
分析测试结果：
看起来似乎没什么问题，但是在最开始的时候，就介绍过如果使用消息属性上设置 TTL 的方式，消息可能并不会按时 “死亡” ，因为RabbitMQ 只会检查第一个消息是否过期，如果过期则丢到死信队列，如果第一个消息的延时时长很长，而第二个消息的延时时长很短，第二个消息并不会优先得到执行 。
3.3 Rabbitmq 插件实现延迟队列
上文中提到的问题，确实是一个问题，如果不能实现在消息粒度上的 TTL，并使其在设置的 TTL 时间 及时死亡，就无法设计成一个通用的延时队列。那如何解决呢，接下来我们就去解决该问题。
我们可以通过安装一个：rabbitmq-delayed-message-exchange 插件 来解决这个问题。这个插件是如何解决的呢：既然延时队列，将消息放入到队列当中存在，一个消息过期时间优先级的问题，那么我们就不将延时的消息，放入到队列当中，而是通过交换机进行处理。
rabbitmq-delayed-message-exchange 插件 就是让我们延时的消息，可以不走队列，而是通过交换机本身进行一个处理，让消费者直接从交换机当中消费，读取消息。
消息发送后不会直接投递到队列，
而是存储到 Mnesia（嵌入式数据库），检查 x-delay 时间（消息头部）；
延迟插件在 RabbitMQ 3.5.7 及以上的版本才支持，依赖 Erlang/OPT 18.0 及以上运行环境；
Mnesia 是一个小型数据库，不适合于大量延迟消息的实现
解决了消息过期时间不一致(优先级)出现的问题。
安装：安装延时队列插件 详细步骤：
在官网上下载：https://www.rabbitmq.com/community-plugins
下载 rabbitmq_delayed_message_exchange 插件
然后解压放置到 RabbitMQ 的插件目录，进入 RabbitMQ 的安装目录下的 plgins 目录，执行下面命令让该插件生效。
[root@RainbowSea plugins]# cd /usr/lib/rabbitmq/lib/rabbitmq_server-3.8.8/plugins # 进入到 RabbitMQ 插件目录
将下载好的 rabbitmq_delayed_message_exchange 插件，上传到 RabbitMQ 的安装目录下的 plgins 目录 当中。
执行 rabbitmq-plugins enable rabbitmq_delayed_message_exchange 命令，启用该插件
[root@RainbowSea plugins]# rabbitmq-plugins enable rabbitmq_delayed_message_exchange
rabbitmq-plugins list 查看所有插件
[root@RainbowSea plugins]# rabbitmq-plugins list
添加成功的效果：
具体代码实现：
在这里新增了一个队列 delayed.queue,一个自定义交换机 delayed.exchange，绑定关系如下:
编写配置类代码：
在我们自定义的交换机中，这是一种新的交换类型，该类型消息支持延迟投递机制 消息传递后并 不会立即投递到目标队列中，而是存储在 mnesia (一个分布式数据系统)表中，当达到投递时间时，才投递到目标队列中。
package com.rainbowsea.rabbitmq.springbootrabbitmq.config;
import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.CustomExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;
@Configuration
public class DelayedQueueConfig {
public static final String DELAYED_QUEUE_NAME = "delayed.queue";
public static final String DELAYED_EXCHANGE_NAME = "delayed.exchange";
public static final String DELAYED_ROUTING_KEY = "delayed.routingkey";
@Bean("delayedQueue") // 声明队列，基于 rabbitmq_delayed_message_exchange 插件的
public Queue delayedQueue() {
return new Queue(DELAYED_QUEUE_NAME);
}
// 声明交换机(可以算是一种自定义交换机)，基于 rabbitmq_delayed_message_exchange 插件的
@Bean("delayedExchange")
public CustomExchange delayedExchange() {
// 创建一个 Map 用于存放，设置队列信息
Map
// 自定义交换机的类型, 这里定义为 direct 直接类型
arguments.put("x-delayed-type", "direct");
/**
* CustomExchange 方法参数
* 1.交换机的名称
* 2.交换机的类型
* 3.是否需要持久化
* 4.是否需要自动删除
* 5.其它的参数
*/
return new CustomExchange(DELAYED_EXCHANGE_NAME, "x-delayed-message", true, false, arguments);
}
// 基于 rabbitmq_delayed_message_exchange 插件的 将队列绑定到交换机当中
@Bean
public Binding delayedQueueBindingdelayedExchange(
@Qualifier("delayedQueue") Queue delayedQueue,
@Qualifier("delayedExchange") CustomExchange delayedExchange) {
return BindingBuilder.bind(delayedQueue).to(delayedExchange).with(DELAYED_ROUTING_KEY).noargs();
}
}
生产者-发送消息的： 这里我们使用的是，通过生产者，设置延时时间，而不是通过队列写死延时时间的方式。
import com.rainbowsea.rabbitmq.springbootrabbitmq.config.DelayedQueueConfig;
import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.Date;
/**
* 生产者：发送延时消息
* http://localhost:8080/ttl/sendMsg/嘻嘻嘻
*/
@RestController
@RequestMapping("ttl")
@Slf4j
public class SendMsgController {
@Resource // 注入到 IOC 容器当中
private RabbitTemplate rabbitTemplate;
@GetMapping("sendDelayMsg/{message}/{delayTime}")
public void sendMsg(@PathVariable String message, @PathVariable Integer delayTime) {
log.info(" 当前时间: {}, 发送一条延迟{} 毫秒的信息给队列 delayed.queue:{}", new Date(), delayTime, message);
rabbitTemplate.convertAndSend(DelayedQueueConfig.DELAYED_EXCHANGE_NAME, DelayedQueueConfig.DELAYED_ROUTING_KEY, message,
correlationData -> {
// 发送消息的时候，延迟时长，单位:ms
correlationData.getMessageProperties().setDelay(delayTime);
return correlationData;
});
}
}
消费者/读取/消费——使用插件交换机当中延时的消息：
package com.rainbowsea.rabbitmq.springbootrabbitmq.consumer;
import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import com.rainbowsea.rabbitmq.springbootrabbitmq.config.DelayedQueueConfig;
import java.util.Date;
/**
* 消费者，消费/读取消息，基于rabbitmq_delayed_message_exchange 插件
*/
@Slf4j
@Component
public class DelayQueueConsumer {
// 监听消息
@RabbitListener(queues = DelayedQueueConfig.DELAYED_QUEUE_NAME)
public void receiveDelayQueue(Message message) {
String msg = new String(message.getBody());
log.info("当前时间:{} ,收到延时队列的消息:{}", new Date().toString(), msg);
}
}
运行结果： 浏览器当中发出请求：
http://localhost:8080/ttl/sendDelayMsg/come on baby1/20000
http://localhost:8080/ttl/sendDelayMsg/come on baby2/2000
总结：
延时队列在需要延时处理的场景下非常有用，使用 RabbitMQ 来实现延时队列可以很好的利用 RabbitMQ 的特性，如：消息可靠发送，消息可靠投递，死信队列 来保障消息至少被消费一次以及未被正确处理的消息不会被丢弃。另外，通过 RabbitMQ 集群的特性，可以很好的解决单击故障问题，不会因为单个节点挂掉导致延时队列不可用或者消息丢失。
当然，延时队列还有很多其它选择，比如利用 Java 的 DelayQueue，利用 Redis的 zset，利用 Quartz 或者利用 kafka 的时间轮，这些方式各有特点，看需要适用的场景。
4. 补充：Docker 容器当中安装 message_exchange"延迟插件" 的详细步骤
确定 Docker 容器对应映射的卷的目录位置：
docker inspect rabbitmq
对应的运行结果：
"Mounts": [
{
"Type": "volume",
"Name": "rabbitmq-plugin",
"Source": "/var/lib/docker/volumes/rabbitmq-plugin/_data",
"Destination": "/plugins",
"Driver": "local",
"Mode": "z",
"RW": true,
"Propagation": ""
},
{
"Type": "volume",
"Name": "cca7bc3012f5b76bd6c47a49ca6911184f9076f5f6263b41f4b9434a7f269b11",
"Source": "/var/lib/docker/volumes/cca7bc3012f5b76bd6c47a49ca6911184f9076f5f6263b41f4b9434a7f269b11/_data",
"Destination": "/var/lib/rabbitmq",
"Driver": "local",
"Mode": "",
"RW": true,
"Propagation": ""
}
]
和容器内 /plugins 目录对应的宿主机目录是：/var/lib/docker/volumes/rabbitmq-plugin/_data
注意：这里必须必须必须，将下载到的 插件 拷贝到 RabbitMQ 服务器 plugins 目录下，不然时无法安装成功的。
下载对应的 messaging 延时插件
messaging 延时插件的官网文档地址： https://www.rabbitmq.com/community-plugins
下载在 Docker 容器当中下载安装文件：
wget https://github.com/rabbitmq/rabbitmq-delayed-message-exchange/releases/download/v3.13.0/rabbitmq_delayed_message_exchange-3.13.0.ez
mv rabbitmq_delayed_message_exchange-3.13.0.ez /var/lib/docker/volumes/rabbitmq-plugin/_data
启用该延时插件：
# 登录进入容器内部
docker exec -it rabbitmq /bin/bash
# rabbitmq-plugins命令所在目录已经配置到$PATH环境变量中了，可以直接调用
rabbitmq-plugins enable rabbitmq_delayed_message_exchange
# 退出Docker容器
exit
# 重启Docker容器
docker restart rabbitmq
插件安装成功的，确定，验证：
确认点1：查看当前节点已启用插件的列表：
确认点2：如果创建新交换机时可以在type中看到x-delayed-message选项，那就说明插件安装好了
5. 最后：
“在这个最后的篇章中，我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉，我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底，继续在其他的领域奋斗。感谢你们，我们总会在某个时刻再次相遇。”