在上篇文章 springboot 整合 rabbitmq 中,我们实现了springboot 和rabbitmq的简单整合,这篇文章主要是对上篇文章功能的增强,主要完成如下功能。
需求:
生产者在启动的时候,自动创建好队列、绑定、交换器并设置好 死信交换器、备份交换器(alternate-exchange)。生产者发送消息后,生产者这边需要对发送的消息进行确认,确认RabbitMQ接收到了消息。为了测试未被路由的消息和死信消息,发送方,发送11条正常的,可以被路由到消息队列中的消息,发送一条不可路由到消息队列中的消息,使之进入 alternate-exchange 交换器中。接收方在接收到消息后,随机拒绝一些消息,使之进入 x-dead-letter-exchange 中。
实现如下功能:
1、使用@Bean方式自动实现队列、交换器、绑定的创建。
2、使用@RabbitListener实现队列消息的监听。
3、实现生产者消息确认。
4、实现死信交换器(过期的消息、basic.nack或basic.reject且requeue参数为false或队列满的消息将进入此交换器)。
5、实现备份交换器(alternate-exchange),未被正确路由的消息将会经过此交换器。
部分功能实现要点:
1、生产者消息确认
|- spring.rabbitmq.template.mandatory = true 设置成true
|- spring.rabbitmq.publisher-confirms = true 设置成true
|- 编写一个 java 类,实现 RabbitTemplate.ConfirmCallback 接口,在这个里面我们可以确认消息是否到达了RabbitMQ服务器。
2、死信交换器的实现
|- 申明队列的时候设置 x-dead-letter-exchange 参数
3、处理未被路由的消息
|- 申明交换器的时候设置 alternate-exchange 参数
实现步骤如下:
1、jar包的引入,生产者和消费者都一样
org.springframework.boot spring-boot-starter-amqp org.springframework.boot spring-boot-starter-web org.projectlombok lombok true org.springframework.boot spring-boot-starter-test test
2、生产者 - 配置文件
server: port: 9088 spring: rabbitmq: host: 140.143.237.224 port: 5672 username: root password: root virtual-host: / connection-timeout: 10000 template: mandatory: true publisher-confirms: true
注意:此处需要将 mandatory和publisher-confirms参数设置成true
3、生产者 - 生产者消息确认编写
@Slf4j public class RabbitConfirmCallback implements RabbitTemplate.ConfirmCallback { @Override public void confirm(CorrelationData correlationData, boolean ack, String cause) { log.info("(start)生产者消息确认========================="); log.info("correlationData:[{}]", correlationData); log.info("ack:[{}]", ack); log.info("cause:[{}]", cause); if (!ack) { log.info("消息可能未到达rabbitmq服务器"); } log.info("(end)生产者消息确认========================="); } }
注意:此处需要实现 RabbitTemplate.ConfirmCallback接口,实现消息的确认
4、生产者 - 生产者配置
@Configuration public class RabbitmqConfiguration { @Autowired private RabbitTemplate rabbitTemplate; @PostConstruct public void initRabbitTemplate() { // 设置生产者消息确认 rabbitTemplate.setConfirmCallback(new RabbitConfirmCallback()); } /** * 申明队列 * * @return */ @Bean public Queue queue() { Maparguments = new HashMap<>(4); // 申明死信交换器 arguments.put("x-dead-letter-exchange", "exchange-dlx"); return new Queue("queue-rabbit-springboot-advance", true, false, false, arguments); } /** * 没有路由到的消息将进入此队列 * * @return */ @Bean public Queue unRouteQueue() { return new Queue("queue-unroute"); } /** * 死信队列 * * @return */ @Bean public Queue dlxQueue() { return new Queue("dlx-queue"); } /** * 申明交换器 * * @return */ @Bean public Exchange exchange() { Map arguments = new HashMap<>(4); // 当发往exchange-rabbit-springboot-advance的消息,routingKey和bindingKey没有匹配上时,将会由exchange-unroute交换器进行处理 arguments.put("alternate-exchange", "exchange-unroute"); return new DirectExchange("exchange-rabbit-springboot-advance", true, false, arguments); } @Bean public FanoutExchange unRouteExchange() { // 此处的交换器的名字要和 exchange() 方法中 alternate-exchange 参数的值一致 return new FanoutExchange("exchange-unroute"); } /** * 申明死信交换器 * * @return */ @Bean public FanoutExchange dlxExchange() { return new FanoutExchange("exchange-dlx"); } /** * 申明绑定 * * @return */ @Bean public Binding binding() { return BindingBuilder.bind(queue()).to(exchange()).with("product").noargs(); } @Bean public Binding unRouteBinding() { return BindingBuilder.bind(unRouteQueue()).to(unRouteExchange()); } @Bean public Binding dlxBinding() { return BindingBuilder.bind(dlxQueue()).to(dlxExchange()); } }
注意:x-dead-letter-exchange和alternate-exchange参数的值和交换器中的值需要保持一致
5、生产者 - 编写消息发送者
@Component @Slf4j public class RabbitProducer implements ApplicationListener{ @Autowired private RabbitTemplate rabbitTemplate; @Override public void onApplicationEvent(ContextRefreshedEvent event) { String exchange = "exchange-rabbit-springboot-advance"; String routingKey = "product"; String unRoutingKey = "norProduct"; // 1.发送一条正常的消息 CorrelationData唯一(可以在ConfirmListener中确认消息) IntStream.rangeClosed(0, 10).forEach(num -> { String message = LocalDateTime.now().toString() + "发送第" + (num + 1) + "条消息."; rabbitTemplate.convertAndSend(exchange, routingKey, message, new CorrelationData("routing" + UUID.randomUUID().toString())); log.info("发送一条消息,exchange:[{}],routingKey:[{}],message:[{}]", exchange, routingKey, message); }); // 2.发送一条未被路由的消息,此消息将会进入备份交换器(alternate exchange) String message = LocalDateTime.now().toString() + "发送一条消息."; rabbitTemplate.convertAndSend(exchange, unRoutingKey, message, new CorrelationData("unRouting-" + UUID.randomUUID().toString())); log.info("发送一条消息,exchange:[{}],routingKey:[{}],message:[{}]", exchange, unRoutingKey, message); } }
注意:1、此处发送了2中消息,一种消息可以被正确的路由到消息队列中,另一种由于routingKey是不存在的,因此不会路由到队列中,观察这条消息有没有路由到 alternate-exchange 绑定的队列中。
2、CorrelationData数据需要唯一,此值可用于生产者确认消息。
6、生产者 - 启动类
@SpringBootApplication public class ProducerApplication { public static void main(String[] args) { SpringApplication.run(ProducerApplication.class, args); } }
7、消费者 - 配置文件
server: port: 9087 spring: rabbitmq: host: 140.143.237.224 port: 5672 username: root password: root virtual-host: / connection-timeout: 10000 listener: simple: acknowledge-mode: manual # 手动应答 auto-startup: true default-requeue-rejected: false # 不重回队列 concurrency: 5 max-concurrency: 20 prefetch: 1 # 每次只处理一个信息 retry: enabled: true
8、消费者 - 消息接收
@Component @Slf4j public class RabbitConsumer { /** * 监听 queue-rabbit-springboot-advance 队列 * * @param receiveMessage 接收到的消息 * @param message * @param channel */ @RabbitListener(queues = "queue-rabbit-springboot-advance") public void receiveMessage(String receiveMessage, Message message, Channel channel) { try { // 手动签收 log.info("接收到消息:[{}]", receiveMessage); if (new Random().nextInt(10) < 5) { log.warn("拒绝一条信息:[{}],此消息将会由死信交换器进行路由.", receiveMessage); channel.basicNack(message.getMessageProperties().getDeliveryTag(), false, false); } else { channel.basicAck(message.getMessageProperties().getDeliveryTag(), false); } } catch (Exception e) { log.info("接收到消息之后的处理发生异常.", e); try { channel.basicAck(message.getMessageProperties().getDeliveryTag(), false); } catch (IOException e1) { log.error("签收异常.", e1); } } } }
注意:消费者接收中会随机拒绝几条消息,观察这个消息有没有进入 x-dead-letter-exchange 交换器绑定的队列中。
完整代码:
代码如下:https://gitee.com/huan1993/rabbitmq/tree/master/rabbitmq-springboot-advanced