1. 默认情况

首先我们来看看默认情况。

默认情况下,消息是不会过期的,也就是我们平日里在消息发送时,如果不设置任何消息过期的相关参数,那么消息是不会过期的,即使消息没被消费掉,也会一直存储在队列中。

这种情况具体代码就不用我再演示了吧,松哥之前的文章凡是涉及到 RabbitMQ 的,基本上都是这样的。

2. TTL

TTL(Time-To-Live),消息存活的时间,即消息的有效期。如果我们希望消息能够有一个存活时间,那么我们可以通过设置 TTL 来实现这一需求。如果消息的存活时间超过了 TTL 并且还没有被消费,此时消息就会变成死信,关于死信以及死信队列,松哥后面再和大家介绍。

TTL 的设置有两种不同的方式:

  1. 在声明队列的时候,我们可以在队列属性中设置消息的有效期,这样所有进入该队列的消息都会有一个相同的有效期。
  2. 在发送消息的时候设置消息的有效期,这样不同的消息就具有不同的有效期。

那如果两个都设置了呢?

以时间短的为准。

当我们设置了消息有效期后,消息过期了就会被从队列中删除了(进入到死信队列,后文一样,不再标注),但是两种方式对应的删除时机有一些差异:

  1. 对于第一种方式,当消息队列设置过期时间的时候,那么消息过期了就会被删除,因为消息进入 RabbitMQ 后是存在一个消息队列中,队列的头部是最早要过期的消息,所以 RabbitMQ 只需要一个定时任务,从头部开始扫描是否有过期消息,有的话就直接删除。
  2. 对于第二种方式,当消息过期后并不会立马被删除,而是当消息要投递给消费者的时候才会去删除,因为第二种方式,每条消息的过期时间都不一样,想要知道哪条消息过期,必须要遍历队列中的所有消息才能实现,当消息比较多时这样就比较耗费性能,因此对于第二种方式,当消息要投递给消费者的时候才去删除。

介绍完 TTL 之后,接下来我们来看看具体用法。

2.1. 单条消息过期

我们先来看单条消息的过期时间。

新创建一个empty project,工程名叫做mq_ttl

06-RabbitMQ消息有效期 - 图1

在这个mq_ttl工程中用Spring Initializr的方式创建两个SpringBoot的module

06-RabbitMQ消息有效期 - 图2

创建一个模块,模块名叫做message_ttl

06-RabbitMQ消息有效期 - 图3

选择依赖

06-RabbitMQ消息有效期 - 图4

在message_ttl模块的application.properties配置文件中作如下配置:

  1. spring.rabbitmq.host=localhost
  2. spring.rabbitmq.port=5672
  3. spring.rabbitmq.username=guest
  4. spring.rabbitmq.password=guest
  5. spring.rabbitmq.virtual-host=/

在message_ttl模块的org.javaboy.message_ttl.config包下创建一个配置类

  1. @Configuration
  2. public class RabbitConfig {
  3. public static final String JAVABOY_MESSSAGE_DELAY_QUEUE_NAME = "javaboy_messsage_delay_queue_name";
  4. public static final String JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME = "javaboy_messsage_delay_exchange_name";
  5. @Bean
  6. Queue messageDelayQueue() {
  7. return new Queue(JAVABOY_MESSSAGE_DELAY_QUEUE_NAME, true, false, false);
  8. }
  9. @Bean
  10. DirectExchange messageDelayExchange() {
  11. return new DirectExchange(JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME, true, false);
  12. }
  13. @Bean
  14. Binding messageDelayQueueBinding() {
  15. return BindingBuilder.bind(messageDelayQueue())
  16. .to(messageDelayExchange())
  17. .with(JAVABOY_MESSSAGE_DELAY_QUEUE_NAME);
  18. }
  19. }

这个配置类主要干了三件事:配置消息队列、配置交换机以及将两者绑定在一起。

  1. 首先配置一个消息队列,new 一个 Queue:第一个参数是消息队列的名字;第二个参数表示消息是否持久化;第三个参数表示消息队列是否排他,一般我们都是设置为 false,即不排他;第四个参数表示如果该队列没有任何订阅的消费者的话,该队列会被自动删除,一般适用于临时队列。
  2. 配置一个 DirectExchange 交换机。
  3. 将交换机和队列绑定到一起。

这段配置应该很简单,没啥好解释的,有一个排他性,松哥这里稍微多说两句:

关于排他性,如果设置为 true,则该消息队列只有创建它的 Connection 才能访问,其他的 Connection 都不能访问该消息队列,如果试图在不同的连接中重新声明或者访问排他性队列,那么系统会报一个资源被锁定的错误。另一方面,对于排他性队列而言,当连接断掉的时候,该消息队列也会自动删除(无论该队列是否被声明为持久性队列都会被删除)。

在message_ttl模块的org.javaboy.message_ttl.controller包下创建控制器

  1. @RestController
  2. public class HelloController {
  3. @Autowired
  4. RabbitTemplate rabbitTemplate;
  5. @GetMapping("/send")
  6. public void hello() {
  7. Message msg = MessageBuilder.withBody("hello javaboy!".getBytes())
  8. //设置过期时间为10s,消息到达 RabbitMQ 10s 之内,如果没有人消费,则消息会过期
  9. .setExpiration("10000")
  10. .build();
  11. rabbitTemplate.send(RabbitConfig.JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME, RabbitConfig.JAVABOY_MESSSAGE_DELAY_QUEUE_NAME, msg);
  12. }
  13. }

在创建 Message 对象的时候我们可以设置消息的过期时间,这里设置消息的过期时间为 10 秒。

接下来我们启动项目,进行消息发送测试。当消息发送成功之后,由于没有消费者,所以这条消息并不会被消费。打开 RabbitMQ 管理页面,点击到 Queues 选项卡,10s 之后,我们会发现消息已经不见了:

单条消息设置过期时间,就是在消息发送的时候设置一下消息有效期即可。

2.2. 队列消息过期

创建另一个模块,模块名叫做queues_ttl,然后选择和message_ttl模块一样的依赖即可

06-RabbitMQ消息有效期 - 图5

在queues_ttl模块的application.properties配置文件中作如下配置:

  1. spring.rabbitmq.host=localhost
  2. spring.rabbitmq.port=5672
  3. spring.rabbitmq.username=guest
  4. spring.rabbitmq.password=guest
  5. spring.rabbitmq.virtual-host=/

在queues_ttl模块的org.javaboy.queues_ttl.config包下创建一个配置类

  1. @Configuration
  2. public class RabbitConfig {
  3. public static final String JAVABOY_QUEUES_DELAY_QUEUE_NAME = "javaboy_queues_delay_queue_name";
  4. public static final String JAVABOY_QUEUES_DELAY_EXCHANGE_NAME = "javaboy_queues_delay_exchange_name";
  5. @Bean
  6. Queue messageDelayQueue() {
  7. Map<String, Object> args = new HashMap<>();
  8. //给消息队列设置过期时间,该队列中的消息如果10s之内没人消费,则过期
  9. args.put("x-message-ttl", 10000);
  10. return new Queue(JAVABOY_QUEUES_DELAY_QUEUE_NAME, true, false, false,args);
  11. }
  12. @Bean
  13. DirectExchange messageDelayExchange() {
  14. return new DirectExchange(JAVABOY_QUEUES_DELAY_EXCHANGE_NAME, true, false);
  15. }
  16. @Bean
  17. Binding messageDelayQueueBinding() {
  18. return BindingBuilder.bind(messageDelayQueue())
  19. .to(messageDelayExchange())
  20. .with(JAVABOY_QUEUES_DELAY_QUEUE_NAME);
  21. }
  22. }

在queues_ttl模块的org.javaboy.queues_ttl.controller包下创建控制器

  1. @RestController
  2. public class HelloController {
  3. @Autowired
  4. RabbitTemplate rabbitTemplate;
  5. @GetMapping("/send")
  6. public void hello() {
  7. rabbitTemplate.convertAndSend(RabbitConfig.JAVABOY_QUEUES_DELAY_EXCHANGE_NAME, RabbitConfig.JAVABOY_QUEUES_DELAY_QUEUE_NAME, "hello 江南一点雨");
  8. }
  9. }

注意:如果没有给队列设置过期时间,也没有给消息本身设置过期时间,那这个消息是不会过期的。如果你没有消费,它会一直在那里。

启动queues_ttl应用,浏览器访问http://localhost:8080/send,查看RabbitMQ的web管理页面的Queues选项卡中可以看到刚才发送到消息队列中的消息,但是10s之后就会消失。

2.3. 特殊情况

还有一种特殊情况,就是将消息的过期时间 TTL 设置为 0,这表示如果消息不能立马消费则会被立即丢掉,这个特性可以部分替代 RabbitMQ3.0 以前支持的 immediate 参数,之所以所部分代替,是因为 immediate 参数在投递失败会有 basic.return 方法将消息体返回(这个功能可以利用死信队列来实现)。

具体代码松哥就不演示了,这个应该比较容易。

3. 死信队列

有小伙伴不禁要问,被删除的消息去哪了?真的被删除了吗?非也非也!这就涉及到死信队列了,接下来我们来看看死信队列。

3.1. 死信交换机

死信交换机,Dead-Letter-Exchange 即 DLX。

死信交换机用来接收死信消息(Dead Message)的,那什么是死信消息呢?一般消息变成死信消息有如下几种情况:

  • 消息被拒绝(Basic.Reject/Basic.Nack) ,井且设置requeue 参数为false
  • 消息过期
  • 队列达到最大长度

当消息在一个队列中变成了死信消息后,此时就会被发送到 DLX,绑定 DLX 的消息队列则称为死信队列。

DLX 本质上也是一个普普通通的交换机,我们可以为任意队列指定 DLX,当该队列中存在死信时,RabbitMQ 就会自动的将这个死信发布到 DLX 上去,进而被路由到另一个绑定了 DLX 的队列上(即死信队列)。

3.2. 死信队列

这个好理解,绑定了死信交换机的队列就是死信队列。

3.3. 实践

通过Spring Initializr的方式新创建一个SpringBoot的project,工程名叫做dlx

06-RabbitMQ消息有效期 - 图6

06-RabbitMQ消息有效期 - 图7

选择依赖

06-RabbitMQ消息有效期 - 图8

在dlx工程的application.properties配置文件中作如下配置:

  1. spring.rabbitmq.host=localhost
  2. spring.rabbitmq.port=5672
  3. spring.rabbitmq.username=guest
  4. spring.rabbitmq.password=guest
  5. spring.rabbitmq.virtual-host=/

在dlx工程的org.javaboy.dlx.config包下创建一个死信队列的配置类

  1. @Configuration
  2. public class RabbitDlxConfig {
  3. public static final String DLX_EXCHANGE_NAME = "dlx_exchange_name";
  4. public static final String DLX_QUEUE_NAME = "dlx_queue_name";
  5. @Bean
  6. DirectExchange dlxDirectExchange() {
  7. return new DirectExchange(DLX_EXCHANGE_NAME, true, false);
  8. }
  9. @Bean
  10. Queue dlxQueue() {
  11. return new Queue(DLX_QUEUE_NAME, true, false, false);
  12. }
  13. @Bean
  14. Binding dlxBinding() {
  15. return BindingBuilder.bind(dlxQueue())
  16. .to(dlxDirectExchange())
  17. .with(DLX_QUEUE_NAME);
  18. }
  19. }

在dlx工程的org.javaboy.dlx.config包下创建一个普通消息队列的配置类

  1. @Configuration
  2. public class RabbitConfig {
  3. public static final String MSG_EXCHANGE_NAME = "msg_exchange_name";
  4. public static final String MSG_QUEUE_NAME = "msg_queue_name";
  5. @Bean
  6. DirectExchange msgDirectExchange() {
  7. return new DirectExchange(MSG_EXCHANGE_NAME, true, false);
  8. }
  9. @Bean
  10. Queue msgQueue() {
  11. Map<String, Object> args = new HashMap<>();
  12. //设置消息过期时间,消息过期之后吧,立马就会进入到死信队列中
  13. args.put("x-message-ttl", 0);
  14. //指定死信队列的交换机
  15. args.put("x-dead-letter-exchange", RabbitDlxConfig.DLX_EXCHANGE_NAME);
  16. //指定死信队列路由的 key
  17. args.put("x-dead-letter-routing-key", RabbitDlxConfig.DLX_QUEUE_NAME);
  18. return new Queue(MSG_QUEUE_NAME, true, false, false,args);
  19. }
  20. @Bean
  21. Binding msgBinding() {
  22. return BindingBuilder.bind(msgQueue())
  23. .to(msgDirectExchange())
  24. .with(MSG_QUEUE_NAME);
  25. }
  26. }

在dlx工程的org.javaboy.dlx.controller包下面创建一个控制器

  1. @RestController
  2. public class HelloController {
  3. @Autowired
  4. RabbitTemplate rabbitTemplate;
  5. @GetMapping("/send")
  6. public void hello() {
  7. rabbitTemplate.convertAndSend(RabbitConfig.MSG_EXCHANGE_NAME, RabbitConfig.MSG_QUEUE_NAME, "hello 江南一点雨");
  8. }
  9. }

在dlx工程的org.javaboy.dlx.consumer包下面创建一个死信队列的消费者

  1. @Component
  2. public class DlxConsumer {
  3. @RabbitListener(queues = RabbitDlxConfig.DLX_QUEUE_NAME)
  4. public void handle(String msg) {
  5. System.out.println("msg = " + msg);
  6. }
  7. }

启动应用,浏览器访问http://localhost:8080/send,然后查看控制台是否打印了死信队列的消息

06-RabbitMQ消息有效期 - 图9