SpringBoot : ch11 整合RabbitMQ
前言
在当今的互联网时代，消息队列成为了构建高可靠、高性能系统的重要组件之一。RabbitMQ作为一个可靠、灵活的消息中间件，被广泛应用于各种分布式系统中。
本篇博客将介绍如何使用Spring Boot整合RabbitMQ，实现消息的发送和接收。通过这种方式，我们可以实现系统之间的解耦，提高系统的可靠性和扩展性。
在开始之前，我们需要先了解一些基本概念。RabbitMQ是一个基于AMQP（高级消息队列协议）的消息中间件，它采用了生产者-消费者模型。生产者负责发送消息到消息队列，而消费者则从队列中接收并处理消息。这种模型使得系统的各个组件可以并行工作，提高了系统的吞吐量和响应速度。
为了使用RabbitMQ，我们首先需要安装和配置它。RabbitMQ提供了丰富的功能和管理界面，可以通过简单的命令进行安装和配置。安装完成后，我们可以使用Spring Boot提供的RabbitMQ Starter来方便地集成RabbitMQ到我们的项目中。
本篇博客将从如何配置RabbitMQ开始，介绍如何创建生产者和消费者，并通过代码示例详细说明它们的使用方法。这个案例将展示如何通过消息队列传递订单信息。
一、安装RabbitMQ
教程地址：RabbitMQ 安装及配置-CSDN博客
二、RabbitMQ 基本概念
RabbitMQ是一个功能强大的开源消息中间件，它基于AMQP（Advanced Message Queuing Protocol，高级消息队列协议）实现了可靠的消息传递。在学习如何使用Spring Boot整合RabbitMQ之前，我们需要了解一些RabbitMQ的基本概念。
-
消息(Message)：在RabbitMQ中，消息是指要传递的数据单元。它由一个消息体和一些可选的属性组成。消息体是实际要传递的数据，而属性则包含一些描述性的信息，例如消息的优先级、过期时间等。
-
生产者(Producer)：生产者是消息的发送方。它负责将消息发送到RabbitMQ的交换机(exchange)中，并指定一个路由键(routing key)。交换机根据路由键将消息路由到一个或多个队列(queue)中。
-
交换机(Exchange)：交换机是消息的分发中心，它接收从生产者发送的消息，并根据路由键将消息路由到一个或多个队列中。RabbitMQ提供了几种不同类型的交换机，包括直连交换机(direct exchange)、主题交换机(topic exchange)、扇形交换机(fanout exchange)和头交换机(headers exchange)。
-
队列(Queue)：队列是消息的存储区域，用于存储交换机发送过来的消息。每个队列都有一个名称，并且可以绑定到一个或多个交换机上。消费者可以从队列中接收消息，并进行相应的处理。
-
消费者(Consumer)：消费者是消息的接收方。它订阅一个或多个队列，并从队列中接收和处理消息。消费者可以以同步或异步的方式接收消息，可以手动确认消息的接收，也可以设置自动确认模式。
-
路由键(Routing Key)：路由键是生产者在发送消息时指定的一个关键字。交换机根据路由键将消息路由到一个或多个队列中。不同类型的交换机对路由键的匹配规则有不同的要求。
以上是一些RabbitMQ的基本概念，了解这些概念对于理解和使用RabbitMQ非常重要。在后续的博客中，我们将深入探讨这些概念，并通过实际的代码示例演示它们的用法。
三、前期准备
1、新建项目，结构如下
2、导入依赖
org.springframework.boot
spring-boot-starter-amqp
org.projectlombok
lombok
org.springframework.boot
spring-boot-starter-test
test
org.springframework.amqp
spring-rabbit-test
test
org.springframework.boot
spring-boot-dependencies
${spring-boot.version}
pom
import
org.apache.maven.plugins
maven-compiler-plugin
3.8.1
1.8
1.8
UTF-8
org.springframework.boot
spring-boot-maven-plugin
${spring-boot.version}
edu.nf.ch11.Ch11Application
true
repackage
repackage
部分包含了项目的依赖项。在这里，你定义了项目所需的各种依赖库。例如，spring-boot-starter-amqp是Spring Boot提供的用于集成AMQP（包括RabbitMQ）的起步依赖，而lombok是一个Java库，可以通过注解来减少样板代码。另外，还有一些用于测试的依赖项，比如spring-boot-starter-test和spring-rabbit-test。
部分通常用来集中管理依赖项的版本号。在这个例子中，它引入了org.springframework.boot:spring-boot-dependencies这个POM文件，并指定了版本号${spring-boot.version}。这样一来，项目中引用的Spring Boot相关的依赖都会使用统一的版本号，便于管理。
部分包含了项目的构建配置。其中的定义了Maven构建过程中需要使用的插件。比如，maven-compiler-plugin指定了Java编译器的版本和编码方式，而spring-boot-maven-plugin则用于打包Spring Boot应用。在这里，它被配置为跳过执行（），因此在实际构建过程中不会执行打包操作。true 这些配置文件是构建一个基于Spring Boot和RabbitMQ的应用所必需的，它们定义了项目的依赖项、构建方式以及其他相关设置.
四、配置 RabbitMQ 配置类
@Configuration
public class RabbitConfig {
public static final String EXCHANGE_NAME = "test.exchange";
public static final String QUEUE_NAME = "test.queue";
public static final String ROUTER_KEY = "KEY.TEST";
/**
* 装配交换机
* @return
*/
@Bean
public DirectExchange exchange(){
return new DirectExchange(EXCHANGE_NAME);
}
/**
* 装配队列
* @return
*/
@Bean
public Queue queue(){
return new Queue(QUEUE_NAME,false);
}
/**
* 将队列绑定到交换机
* @return
*/
@Bean
public Binding binding(){
return BindingBuilder
.bind(queue())
.to(exchange())
.with(ROUTER_KEY);
}
/**
* 装配自定义消息转换器
* @return
*/
@Bean
public MessageConverter messageConverter(){
return new Jackson2JsonMessageConverter();
}
}
这段代码是一个用于配置RabbitMQ的类。让我解释一下其中的作用：
@Configuration注解表示这是一个配置类，Spring会扫描该类并将其作为Bean定义加载到应用程序上下文中。
exchange()方法使用@Bean注解将一个DirectExchange实例作为Bean加载到应用程序上下文中。DirectExchange是RabbitMQ中的一种类型的交换机，它通过指定的路由键将消息发送到与之匹配的队列。
queue()方法使用@Bean注解将一个Queue实例作为Bean加载到应用程序上下文中。这个队列用于接收RabbitMQ中的消息。
binding()方法使用@Bean注解将一个Binding实例作为Bean加载到应用程序上下文中。Binding用于将队列绑定到交换机并指定路由键。
messageConverter()方法使用@Bean注解将一个MessageConverter实例作为Bean加载到应用程序上下文中。在这里，使用了Jackson2JsonMessageConverter，它是一个自定义的消息转换器，用于将消息以JSON格式进行序列化和反序列化。通过使用这些Bean定义，你可以方便地配置RabbitMQ的交换机、队列、绑定关系以及消息转换器。
五、实体类
@Data
public class Order {
private String orderId;
}存放订单信息。
六、生产者代码
@Slf4j
@Service
@RequiredArgsConstructor
public class ProducerService {
private final RabbitTemplate template;
public void sendMessage(Order order){
// 创建消息的唯一id
CorrelationData correlationData = new CorrelationData();
correlationData.setId(UUID.randomUUID().toString());
// 发送消息
template.convertAndSend(RabbitConfig.EXCHANGE_NAME,RabbitConfig.ROUTER_KEY,order,correlationData);
// 确认发送成功
template.setConfirmCallback((cdata,ack,cause) -> {
if (ack){
log.info("消息：" + cdata.getId() + "投递成功");
}
});
}
}
这段代码是一个名为ProducerService的服务类，使用了RabbitTemplate来发送消息到RabbitMQ消息队列。
在sendMessage方法中，首先创建了一个唯一的消息id，然后使用RabbitTemplate的convertAndSend方法将消息发送到指定的交换机（exchange）和路由键（routing key）。同时也传入了一个CorrelationData对象作为附加数据。
接着，通过设置RabbitTemplate的确认回调（confirm callback），可以确保消息的投递成功。在回调函数中，判断ack参数是否为true，如果为true，则表示消息投递成功，并打印相关日志信息。
七、消费者代码
@Slf4j
@Service
@RabbitListener(queues = RabbitConfig.QUEUE_NAME)
public class ConsumerService {
@RabbitHandler
public void receive(Order order){
log.info("处理订单：" + order.getOrderId());
}
}
这段代码是一个消费者服务类，使用了@RabbitListener注解来监听名为RabbitConfig.QUEUE_NAME的队列。当队列中有消息到达时，会调用receive方法来处理接收到的消息。
在receive方法中，通过参数Order order来接收从队列中获取的订单消息，并打印处理订单的相关日志信息。
需要注意的是，@RabbitHandler注解用于标识该方法为消息处理方法，用来处理从队列中接收到的消息。同时，消费者需要配置好RabbitMQ的连接信息以及队列的绑定关系，确保能够正确地从指定的队列中接收消息并进行处理。
八、测试
1、在Rabbitmq的后台UI页面查看交换机
等下我们测试的时候，成功的话会产生一个新的交换机，我能现在查看就是为了确保等一下代码测试的结果。
2、测试结果
@Autowired
private ProducerService service;
@Test
void testSendMessage() {
Order order = new Order();
order.setOrderId("ABC123");
service.sendMessage(order);
}这段代码是一个单元测试方法，用于测试ProducerService类中的sendMessage方法。首先通过@Autowired注解将ProducerService类注入到当前测试类中。
在testSendMessage方法中，创建了一个订单对象，并设置订单号为ABC123。接着调用service的sendMessage方法，将订单消息发送到RabbitMQ的消息队列中。
需要注意的是，由于这是一个单元测试方法，测试环境中需要正确配置RabbitMQ的连接信息、交换机和队列等信息，确保能够正常发送和接收消息。同时，在进行测试时，可以通过查看相关日志信息来确认消息是否成功发送和接收。
运行结果：
生产成功了，并且消费也成功了，我们去UI页面查看一下。
3、查看后台的数据
有我们刚刚新添加的交换机。
在消费的时候会有相应的信息显示。
这部分数据看起来是关于RabbitMQ中队列状态的概况。让我解释一下这些数据的含义：
- Virtual host: 虚拟主机的名称。
- Name: 队列的名称。
- Type: 队列的类型，这里显示为 "classic"，表示这是一个经典队列。
- State: 队列的状态，这里显示为 "idle"，表示队列处于空闲状态。
- Ready: 队列中准备就绪的消息数量，这里显示为0。
- Unacked: 未确认的消息数量，这里显示为0。
- Total incoming: 总共进入队列的消息数量，这里显示为0.20条/秒。
- Deliver / Get: 传递/获取消息的速率，这里显示为0.20条/秒。
- Ack: 确认消息的速率，这里显示为0.20条/秒。
根据这些数据，队列目前处于空闲状态，但是有消息以每秒0.20条的速率进入队列，并以同样的速率被传递和确认。
注意：不会一直显示的，当消费完之后就会变回0了。
九、什么是RabbitMQ的生产者和消费者，区别是什么？
RabbitMQ是一种消息代理（message broker），用于在应用程序之间传递消息。在RabbitMQ中，生产者（producer）是发送消息的应用程序，而消费者（consumer）则是接收和处理这些消息的应用程序。
生产者将消息发布到一个交换机（exchange）中，交换机根据指定的路由键（routing key）将消息路由到一个或多个队列（queue）。消费者订阅这些队列，并从队列中获取消息进行处理。
在RabbitMQ中，生产者和消费者之间是解耦的，它们不需要直接知道对方的存在。生产者只需要知道如何将消息发送到正确的交换机中，而消费者只需要知道如何从正确的队列中获取消息进行处理。
使用RabbitMQ的优点是可以实现异步通信，提高系统的可伸缩性和可靠性。生产者和消费者之间的解耦也使得系统更加灵活和易于维护。
区别：
生产者（Producer）和消费者（Consumer）是在消息队列模式中的两个角色，它们有以下几个主要区别：
-
功能角色：生产者负责生成并发送消息到消息队列，它是消息的发送方；而消费者则从消息队列中接收并处理消息，它是消息的接收方。
-
数据流方向：在消息队列中，数据流是单向的。生产者将消息发布到消息队列，而消费者从消息队列中获取消息进行处理。生产者和消费者之间通过消息队列进行解耦，彼此不直接通信。
-
关注点不同：生产者关注的是如何生成并发送消息，通常是根据业务逻辑生成消息内容；消费者关注的是如何接收和处理消息，通常是基于业务需求对消息进行相应的处理操作。
-
并发性：在消息队列中，可以有多个生产者同时向一个队列发送消息，也可以有多个消费者同时从一个队列接收消息。这样可以实现消息的并发处理，提高系统的吞吐量和响应速度。
-
灵活性：由于生产者和消费者之间通过消息队列进行解耦，因此它们可以独立地进行扩展和部署。可以根据需要增加或删除生产者和消费者，而不会对整个系统造成影响。
总而言之，生产者负责生成和发送消息到消息队列，消费者负责接收和处理消息。它们在功能角色、数据流方向、关注点、并发性和灵活性等方面有所不同。通过合理使用生产者和消费者，可以实现高效的异步通信和解耦的系统架构。