1. 默认情况
首先我们来看看默认情况。
默认情况下,消息是不会过期的,也就是我们平日里在消息发送时,如果不设置任何消息过期的相关参数,那么消息是不会过期的,即使消息没被消费掉,也会一直存储在队列中。
这种情况具体代码就不用我再演示了吧,松哥之前的文章凡是涉及到 RabbitMQ 的,基本上都是这样的。
2. TTL
TTL(Time-To-Live),消息存活的时间,即消息的有效期。如果我们希望消息能够有一个存活时间,那么我们可以通过设置 TTL 来实现这一需求。如果消息的存活时间超过了 TTL 并且还没有被消费,此时消息就会变成死信
,关于死信
以及死信队列
,松哥后面再和大家介绍。
TTL 的设置有两种不同的方式:
- 在声明队列的时候,我们可以在队列属性中设置消息的有效期,这样所有进入该队列的消息都会有一个相同的有效期。
- 在发送消息的时候设置消息的有效期,这样不同的消息就具有不同的有效期。
那如果两个都设置了呢?
以时间短的为准。
当我们设置了消息有效期后,消息过期了就会被从队列中删除了(进入到死信队列,后文一样,不再标注),但是两种方式对应的删除时机有一些差异:
- 对于第一种方式,当消息队列设置过期时间的时候,那么消息过期了就会被删除,因为消息进入 RabbitMQ 后是存在一个消息队列中,队列的头部是最早要过期的消息,所以 RabbitMQ 只需要一个定时任务,从头部开始扫描是否有过期消息,有的话就直接删除。
- 对于第二种方式,当消息过期后并不会立马被删除,而是当消息要投递给消费者的时候才会去删除,因为第二种方式,每条消息的过期时间都不一样,想要知道哪条消息过期,必须要遍历队列中的所有消息才能实现,当消息比较多时这样就比较耗费性能,因此对于第二种方式,当消息要投递给消费者的时候才去删除。
介绍完 TTL 之后,接下来我们来看看具体用法。
2.1. 单条消息过期
我们先来看单条消息的过期时间。
新创建一个empty project,工程名叫做mq_ttl
在这个mq_ttl工程中用Spring Initializr的方式创建两个SpringBoot的module
创建一个模块,模块名叫做message_ttl
选择依赖
在message_ttl模块的application.properties配置文件中作如下配置:
spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=guest
spring.rabbitmq.password=guest
spring.rabbitmq.virtual-host=/
在message_ttl模块的org.javaboy.message_ttl.config包下创建一个配置类
@Configuration
public class RabbitConfig {
public static final String JAVABOY_MESSSAGE_DELAY_QUEUE_NAME = "javaboy_messsage_delay_queue_name";
public static final String JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME = "javaboy_messsage_delay_exchange_name";
@Bean
Queue messageDelayQueue() {
return new Queue(JAVABOY_MESSSAGE_DELAY_QUEUE_NAME, true, false, false);
}
@Bean
DirectExchange messageDelayExchange() {
return new DirectExchange(JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME, true, false);
}
@Bean
Binding messageDelayQueueBinding() {
return BindingBuilder.bind(messageDelayQueue())
.to(messageDelayExchange())
.with(JAVABOY_MESSSAGE_DELAY_QUEUE_NAME);
}
}
这个配置类主要干了三件事:配置消息队列、配置交换机以及将两者绑定在一起。
- 首先配置一个消息队列,new 一个 Queue:第一个参数是消息队列的名字;第二个参数表示消息是否持久化;第三个参数表示消息队列是否排他,一般我们都是设置为 false,即不排他;第四个参数表示如果该队列没有任何订阅的消费者的话,该队列会被自动删除,一般适用于临时队列。
- 配置一个 DirectExchange 交换机。
- 将交换机和队列绑定到一起。
这段配置应该很简单,没啥好解释的,有一个排他性,松哥这里稍微多说两句:
关于排他性,如果设置为 true,则该消息队列只有创建它的 Connection 才能访问,其他的 Connection 都不能访问该消息队列,如果试图在不同的连接中重新声明或者访问排他性队列,那么系统会报一个资源被锁定的错误。另一方面,对于排他性队列而言,当连接断掉的时候,该消息队列也会自动删除(无论该队列是否被声明为持久性队列都会被删除)。
在message_ttl模块的org.javaboy.message_ttl.controller包下创建控制器
@RestController
public class HelloController {
@Autowired
RabbitTemplate rabbitTemplate;
@GetMapping("/send")
public void hello() {
Message msg = MessageBuilder.withBody("hello javaboy!".getBytes())
//设置过期时间为10s,消息到达 RabbitMQ 10s 之内,如果没有人消费,则消息会过期
.setExpiration("10000")
.build();
rabbitTemplate.send(RabbitConfig.JAVABOY_MESSSAGE_DELAY_EXCHANGE_NAME, RabbitConfig.JAVABOY_MESSSAGE_DELAY_QUEUE_NAME, msg);
}
}
在创建 Message 对象的时候我们可以设置消息的过期时间,这里设置消息的过期时间为 10 秒。
接下来我们启动项目,进行消息发送测试。当消息发送成功之后,由于没有消费者,所以这条消息并不会被消费。打开 RabbitMQ 管理页面,点击到 Queues 选项卡,10s 之后,我们会发现消息已经不见了:
单条消息设置过期时间,就是在消息发送的时候设置一下消息有效期即可。
2.2. 队列消息过期
创建另一个模块,模块名叫做queues_ttl,然后选择和message_ttl模块一样的依赖即可
在queues_ttl模块的application.properties配置文件中作如下配置:
spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=guest
spring.rabbitmq.password=guest
spring.rabbitmq.virtual-host=/
在queues_ttl模块的org.javaboy.queues_ttl.config包下创建一个配置类
@Configuration
public class RabbitConfig {
public static final String JAVABOY_QUEUES_DELAY_QUEUE_NAME = "javaboy_queues_delay_queue_name";
public static final String JAVABOY_QUEUES_DELAY_EXCHANGE_NAME = "javaboy_queues_delay_exchange_name";
@Bean
Queue messageDelayQueue() {
Map<String, Object> args = new HashMap<>();
//给消息队列设置过期时间,该队列中的消息如果10s之内没人消费,则过期
args.put("x-message-ttl", 10000);
return new Queue(JAVABOY_QUEUES_DELAY_QUEUE_NAME, true, false, false,args);
}
@Bean
DirectExchange messageDelayExchange() {
return new DirectExchange(JAVABOY_QUEUES_DELAY_EXCHANGE_NAME, true, false);
}
@Bean
Binding messageDelayQueueBinding() {
return BindingBuilder.bind(messageDelayQueue())
.to(messageDelayExchange())
.with(JAVABOY_QUEUES_DELAY_QUEUE_NAME);
}
}
在queues_ttl模块的org.javaboy.queues_ttl.controller包下创建控制器
@RestController
public class HelloController {
@Autowired
RabbitTemplate rabbitTemplate;
@GetMapping("/send")
public void hello() {
rabbitTemplate.convertAndSend(RabbitConfig.JAVABOY_QUEUES_DELAY_EXCHANGE_NAME, RabbitConfig.JAVABOY_QUEUES_DELAY_QUEUE_NAME, "hello 江南一点雨");
}
}
注意:如果没有给队列设置过期时间,也没有给消息本身设置过期时间,那这个消息是不会过期的。如果你没有消费,它会一直在那里。
启动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
选择依赖
在dlx工程的application.properties配置文件中作如下配置:
spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=guest
spring.rabbitmq.password=guest
spring.rabbitmq.virtual-host=/
在dlx工程的org.javaboy.dlx.config包下创建一个死信队列的配置类
@Configuration
public class RabbitDlxConfig {
public static final String DLX_EXCHANGE_NAME = "dlx_exchange_name";
public static final String DLX_QUEUE_NAME = "dlx_queue_name";
@Bean
DirectExchange dlxDirectExchange() {
return new DirectExchange(DLX_EXCHANGE_NAME, true, false);
}
@Bean
Queue dlxQueue() {
return new Queue(DLX_QUEUE_NAME, true, false, false);
}
@Bean
Binding dlxBinding() {
return BindingBuilder.bind(dlxQueue())
.to(dlxDirectExchange())
.with(DLX_QUEUE_NAME);
}
}
在dlx工程的org.javaboy.dlx.config包下创建一个普通消息队列的配置类
@Configuration
public class RabbitConfig {
public static final String MSG_EXCHANGE_NAME = "msg_exchange_name";
public static final String MSG_QUEUE_NAME = "msg_queue_name";
@Bean
DirectExchange msgDirectExchange() {
return new DirectExchange(MSG_EXCHANGE_NAME, true, false);
}
@Bean
Queue msgQueue() {
Map<String, Object> args = new HashMap<>();
//设置消息过期时间,消息过期之后吧,立马就会进入到死信队列中
args.put("x-message-ttl", 0);
//指定死信队列的交换机
args.put("x-dead-letter-exchange", RabbitDlxConfig.DLX_EXCHANGE_NAME);
//指定死信队列路由的 key
args.put("x-dead-letter-routing-key", RabbitDlxConfig.DLX_QUEUE_NAME);
return new Queue(MSG_QUEUE_NAME, true, false, false,args);
}
@Bean
Binding msgBinding() {
return BindingBuilder.bind(msgQueue())
.to(msgDirectExchange())
.with(MSG_QUEUE_NAME);
}
}
在dlx工程的org.javaboy.dlx.controller包下面创建一个控制器
@RestController
public class HelloController {
@Autowired
RabbitTemplate rabbitTemplate;
@GetMapping("/send")
public void hello() {
rabbitTemplate.convertAndSend(RabbitConfig.MSG_EXCHANGE_NAME, RabbitConfig.MSG_QUEUE_NAME, "hello 江南一点雨");
}
}
在dlx工程的org.javaboy.dlx.consumer包下面创建一个死信队列的消费者
@Component
public class DlxConsumer {
@RabbitListener(queues = RabbitDlxConfig.DLX_QUEUE_NAME)
public void handle(String msg) {
System.out.println("msg = " + msg);
}
}