从七年开发视角带你吃透 Spring Boot 整合 RabbitMQ （附全流程实战加工具类）

天天摸鱼的java工程师
932 阅读5分钟

从七年开发视角带你吃透 Spring Boot 整合 RabbitMQ （附全流程实战加工具类）

干了七年开发，经历过无数次系统迭代和性能优化，要说在高并发、复杂业务场景下 “救命” 的技术，RabbitMQ 绝对是其中之一。作为一款成熟的开源消息队列，它能轻松实现系统间解耦、异步处理，大幅提升系统的稳定性和可扩展性。今天就结合我这七年踩过的坑、积累的经验，手把手教你用 Spring Boot 把 RabbitMQ 整合得明明白白，还会附上超详细的工具类代码和注释，让你直接上手开干！

一、为什么要在 Spring Boot 中整合 RabbitMQ？

在实际项目中，经常会遇到一些业务场景，比如电商系统的订单处理、支付通知，还有社交平台的消息推送等。如果采用同步处理，不仅会导致系统响应缓慢，还可能因为某个环节的延迟或故障影响整个业务流程。这时候，RabbitMQ 就派上用场了！它可以作为中间件，将消息发送方和接收方解耦，实现异步通信。发送方只需把消息发送到 RabbitMQ，接收方根据自身处理能力从队列中获取消息进行处理，互不干扰。用 Spring Boot 整合 RabbitMQ，能借助 Spring Boot 的自动化配置和便捷的开发特性，让我们更高效地使用 RabbitMQ，充分发挥它的优势。

二、环境准备

在开始整合之前，确保你的开发环境已经安装好了 JDK（建议 1.8 及以上版本）、Maven（用于管理项目依赖），并且配置好了相关环境变量。此外，还需要安装 RabbitMQ 服务，你可以根据自己的操作系统从RabbitMQ 官方网站下载并安装，安装完成后启动 RabbitMQ 服务。

三、创建 Spring Boot 项目

  1. 使用 Spring Initializr 创建项目：打开Spring Initializr 官网 ，填写项目元数据，如 Group（一般是公司域名倒写，比如 com.example）、Artifact（项目名称），在 Dependencies 中选择 Spring Web 和 Spring for RabbitMQ，然后点击 “Generate” 下载项目压缩包，解压后用 IDE（如 IDEA）打开。
  1. 项目结构概览：项目创建完成后，会形成标准的 Spring Boot 项目结构。src/main/java目录用于存放 Java 代码，src/main/resources目录存放配置文件，src/test/java目录用于编写测试代码。

四、添加 RabbitMQ 依赖

打开项目的pom.xml文件，在标签内添加以下 RabbitMQ 依赖：

<dependencies>
    <!-- Spring Boot Web 依赖，方便后续测试接口 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Spring Boot RabbitMQ 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-amqp</artifactId>
    </dependency>
</dependencies>

添加依赖后，点击 Maven 的刷新按钮，让 Maven 自动下载相关依赖包。

五、配置 RabbitMQ 连接

在src/main/resources目录下找到application.properties文件（如果是application.yml格式，配置方式类似，只是语法不同），添加 RabbitMQ 的连接配置：

# RabbitMQ服务器地址，一般是localhost，如果是远程服务器，填写对应IP
spring.rabbitmq.host=localhost
# RabbitMQ服务器端口，默认是5672
spring.rabbitmq.port=5672
# 用户名
spring.rabbitmq.username=guest
# 密码
spring.rabbitmq.password=guest
# 虚拟主机，默认是/
spring.rabbitmq.virtual-host=/

这些配置就像是给 Spring Boot 程序指明了连接 RabbitMQ 服务器的 “路线图”。

六、编写 RabbitMQ 工具类

在src/main/java目录下创建一个工具类包（比如com.example.utils），然后在包下创建RabbitMqUtils类，代码如下：

package com.example.utils;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
@Component
public class RabbitMqUtils {
    @Autowired
    private RabbitTemplate rabbitTemplate;
    /**
     * 发送消息到指定队列
     * @param queueName 队列名称
     * @param message 消息内容
     */
    public void sendMessage(String queueName, Object message) {
        rabbitTemplate.convertAndSend(queueName, message);
    }
    /**
     * 发送消息到指定交换机和路由键绑定的队列
     * @param exchange 交换机名称
     * @param routingKey 路由键
     * @param message 消息内容
     */
    public void sendMessageToExchange(String exchange, String routingKey, Object message) {
        rabbitTemplate.convertAndSend(exchange, routingKey, message);
    }
}

上述工具类封装了两种常见的消息发送方式，一种是直接发送到队列，另一种是通过交换机和路由键发送到对应的队列，后续在项目中使用时直接调用即可。

七、实战测试

1. 定义队列和交换机

在src/main/java目录下创建config包，然后在包下创建RabbitMqConfig类，用于定义队列、交换机以及它们之间的绑定关系：

package com.example.config;
import org.springframework.amqp.core.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class RabbitMqConfig {
    // 定义队列
    @Bean
    public Queue testQueue() {
        return new Queue("test.queue");
    }
    // 定义交换机
    @Bean
    TopicExchange testExchange() {
        return new TopicExchange("test.exchange");
    }
    // 绑定队列和交换机，并指定路由键
    @Bean
    Binding bindingExchangeQueue() {
        return BindingBuilder.bind(testQueue()).to(testExchange()).with("test.routing.key");
    }
}

2. 编写生产者代码

在controller层编写接口来测试消息发送功能，创建RabbitMqSenderController类：

package com.example.controller;
import com.example.utils.RabbitMqUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class RabbitMqSenderController {
    @Autowired
    private RabbitMqUtils rabbitMqUtils;
    @GetMapping("/sendMessageToQueue")
    public String sendMessageToQueue() {
        String message = "这是一条发送到队列的测试消息";
        rabbitMqUtils.sendMessage("test.queue", message);
        return "消息发送成功";
    }
    @GetMapping("/sendMessageToExchange")
    public String sendMessageToExchange() {
        String message = "这是一条发送到交换机的测试消息";
        rabbitMqUtils.sendMessageToExchange("test.exchange", "test.routing.key", message);
        return "消息发送成功";
    }
}

3. 编写消费者代码

创建RabbitMqReceiver类，用于接收消息：

package com.example;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
@Component
public class RabbitMqReceiver {
    @RabbitListener(queues = "test.queue")
    public void receiveMessage(String message) {
        System.out.println("接收到队列消息：" + message);
    }
    @RabbitListener(queues = "test.queue")
    public void receiveMessageFromExchange(String message) {
        System.out.println("接收到通过交换机路由的队列消息：" + message);
    }
}

启动 Spring Boot 项目，分别访问http://localhost:8080/sendMessageToQueue和http://localhost:8080/sendMessageToExchange接口发送消息，然后查看控制台输出，就能看到消费者成功接收到消息了。

通过以上全流程实战和工具类代码，相信你已经对 Spring Boot 整合 RabbitMQ 有了深入的了解。在实际项目中，你可以根据业务需求灵活运用这些知识，让消息队列在系统中发挥更大的作用。开发的道路永无止境，后续还会有更多复杂的场景和优化技巧等待我们去探索和实践！

avatar
文章
阅读
粉丝