从零到一:Spring Boot 与 RocketMQ 的完美集成指南

news2024/12/24 9:09:56

1.Rocket的概念与原理

RocketMQ 是一款由阿里巴巴开源的分布式消息中间件,最初用于支持阿里巴巴的海量业务。它基于发布-订阅模型,具备高吞吐、低延迟、高可用和强一致性的特点,适用于消息队列、大规模数据流处理等场景。以下是对 RocketMQ 的原理和核心概念的详细介绍,帮助你快速认识和熟悉 RocketMQ。

1. 基础概念

  • Producer(生产者):负责生产消息的角色。Producer 发送消息到 RocketMQ 服务器(Broker),通常有同步、异步和单向发送三种方式。

  • Consumer(消费者):负责消费消息的角色。Consumer 从 Broker 拉取消息进行处理。消费者分为两种模式:

    • Push 模式:Broker 主动推送消息给 Consumer。
    • Pull 模式:Consumer 主动拉取消息。
  • Broker(消息服务器):核心组件,负责接收、存储和转发消息。Broker 还负责存储消息的元数据、处理生产者发送的消息请求以及消费者的消费请求。

  • Name Server:RocketMQ 的注册中心,Producer 和 Consumer 通过 Name Server 发现 Broker。Name Server 维护了所有 Broker 的路由信息,并提供名称解析服务。

  • Topic:消息的逻辑分类标签,Producer 发送消息时指定 Topic,Consumer 根据 Topic 订阅消息。

  • Tag:消息的二级分类,可以让 Consumer 更细粒度地过滤消息。

  • Message Queue(消息队列):每个 Topic 由多个消息队列组成,Producer 发送消息时会指定一个或多个队列。Consumer 从队列中拉取消息。

  • Message(消息):Producer 发送的数据单位。每条消息包含 Topic、Tag、内容、唯一标识符等属性。

  • Group:Producer 和 Consumer 都可以按照业务逻辑进行分组(Group)。Consumer Group 是多个 Consumer 的集合,这些 Consumer 可以消费同一个 Topic 下的消息。

2. 消息发送与消费流程

2.1 消息发送流程
  1. 消息生产:Producer 生成消息并指定目标 Topic。
  2. 路由发现:Producer 通过 Name Server 查询 Topic 对应的 Broker 路由信息。
  3. 消息发送:Producer 根据路由信息,将消息发送到指定的 Broker。Producer 可以选择同步发送、异步发送或者单向发送。
  4. 消息存储:Broker 接收到消息后,将消息存储在本地的 CommitLog 中,同时更新消息的元数据。
2.2 消息消费流程
  1. 订阅消息:Consumer 启动时,向 Name Server 注册自己,并订阅感兴趣的 Topic。
  2. 路由发现:Consumer 通过 Name Server 获取 Topic 对应的 Broker 信息以及消息队列信息。
  3. 拉取消息:Consumer 从 Broker 中拉取消息,并进行消费。消费的位置信息(消费进度)会定期同步到 Broker 端或持久化到本地。
  4. 消息处理:Consumer 处理接收到的消息,处理完毕后根据不同的消费模式(自动或手动)确认消息消费完成。

3. 消息存储机制

  • CommitLog:Broker 将接收到的消息持久化到 CommitLog 文件中,这是 RocketMQ 消息存储的核心文件。消息以追加的方式写入,方便快速写入和批量读取。

  • ConsumeQueue:消费队列,RocketMQ 为每个 Topic 创建对应的消费队列文件。ConsumeQueue 中存储了指向 CommitLog 的偏移量,用于定位消息内容。

  • IndexFile:索引文件,用于根据消息的某些字段(如消息 ID、Key)快速检索消息。

RocketMQ 的消息存储分为三个层次:首先是将消息内容存储在 CommitLog 文件中,然后将消息的位置信息存储在 ConsumeQueue 文件中,最后通过 IndexFile 文件提供快速查询功能。

4. 消息可靠性与事务

4.1 消息可靠性

RocketMQ 通过以下机制保证消息的可靠性:

  • 消息确认机制:Producer 发送消息后,需要等待 Broker 的确认。对于消费者,也有消费确认机制,保证消息被成功处理。
  • 消息重试:Consumer 在消费失败时,RocketMQ 会自动进行消息重试,直到消费成功或达到最大重试次数。
  • 消息持久化:Broker 会将消息持久化到磁盘,确保即使 Broker 崩溃,消息数据依然可以恢复。
4.2 事务消息

RocketMQ 支持事务消息,通过“二阶段提交”保证分布式事务的一致性。Producer 在发送事务消息时,首先发送半消息(Prepared Message),执行本地事务,最后根据事务执行结果来提交(Commit)或回滚(Rollback)消息。

5. 消息过滤与顺序消息

5.1 消息过滤

RocketMQ 提供了基于 Tag 的消息过滤功能,可以在消费端只接收特定 Tag 的消息。这减少了 Consumer 不必要的消息处理,提高了消费效率。

5.2 顺序消息

RocketMQ 支持全局顺序消息和部分顺序消息(分区顺序)。全局顺序消息要求所有消息按顺序发送和消费,通常只有一个队列;而分区顺序消息则允许不同分区(队列)中的消息可以并行处理,但同一分区内的消息必须按顺序处理。

6. 高可用性与集群

  • 主从架构(Master-Slave):RocketMQ 支持主从架构,Master 负责处理所有读写请求,Slave 仅用于备份数据。当 Master 故障时,Slave 可以作为备用 Broker 启动,确保数据不丢失。

  • 集群模式(Cluster Mode):支持多种集群模式,如多 Master 模式、Master-Slave 模式。不同集群模式可以根据业务需求灵活配置,以平衡性能、可靠性和可扩展性。

7. 性能优化与监控

  • 性能优化:RocketMQ 提供了多种手段优化性能,如通过多线程并发处理消息、使用异步 IO 提高吞吐量、调节 Producer 的批量发送、优化消息压缩等。

  • 监控与运维:RocketMQ 提供了丰富的监控指标,可以通过 RocketMQ Console 或者集成 Prometheus、Grafana 进行监控。运维人员可以实时监控消息的生产、消费情况以及 Broker 的运行状态。

RocketMQ 是一款功能强大、性能优异的分布式消息中间件,适用于多种业务场景。通过理解其核心概念和原理,你可以更好地在实际项目中应用 RocketMQ。了解消息的发送与消费流程、存储机制、可靠性保障、事务支持、以及顺序消息的处理等方面的知识,将有助于你更高效地使用和管理 RocketMQ 系统。

2.RocketMQ的安装与启动

要在 Windows 中下载安装 RocketMQ,可以按照以下步骤进行操作:

1. 安装 Java 环境

RocketMQ 依赖 Java 运行时环境 (JRE) 或 Java 开发工具包 (JDK),所以首先需要确保系统上安装了 JDK。

  • 到 Oracle 的官网 下载并安装 JDK 11 或更高版本。
  • 安装完成后,配置 JAVA_HOME 环境变量:
    • 右键点击“此电脑”,选择“属性”。
    • 点击“高级系统设置” -> “环境变量”。
    • 在“系统变量”中点击“新建”,设置 JAVA_HOME 变量,值为 JDK 的安装路径,例如 C:\Program Files\Java\jdk-11.0.10
    • 在系统变量中找到 Path,编辑并添加 %JAVA_HOME%\binPath 中。

2. 下载并解压 RocketMQ

  • 到 Apache RocketMQ 官网 下载最新版本的 RocketMQ 二进制包(目前最新版为 rocketmq-all-5.3.0-bin-release.zip)。
  • 将下载的 ZIP 文件解压到您选择的目录,例如 C:\application\rocketmq\rocketmq-all-5.3.0-bin-release\rocketmq-all-5.3.0-bin-release.
    在这里插入图片描述

3. 配置 RocketMQ环境变量

安装完成后,配置 ROCKETMQ_HOME 环境变量:

  • 右键点击“此电脑”,选择“属性”。
  • 点击“高级系统设置” -> “环境变量”。
  • 在“系统变量”中点击“新建”,设置 ROCKETMQ_HOME 变量,值为 JDK 的安装路径,例如 C:\application\rocketmq\rocketmq-all-5.3.0-bin-release\rocketmq-all-5.3.0-bin-release
  • 在系统变量中找到 Path,编辑并添加 %ROCKETMQ_HOME%\binPath 中。

需要注意的是,如果未配置环境变量,在启动NameServer时会看到提示 Please set the ROCKETMQ_HOME variable in your environment!. 因此,安装最新版RocketMQ后,请确保已设置环境变量。

4. 启动 NameServer 和 Broker

RocketMQ 包含两个主要的服务:NameServer 和 Broker。

4.1 启动 NameServer
  1. 打开命令提示符 (CMD)。
  2. 启动 NameServer:
    start mqnamesrv.cmd
    
  3. 确保 NameServer 启动成功,终端会显示 The Name Server boot success.
    在这里插入图片描述
4.2 启动 Broker
  1. 同样在命令提示符中,执行以下命令启动 Broker:
    start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true
    
  2. 如果成功启动,终端会显示 The broker boot success.
    在这里插入图片描述

5. 验证安装

可以使用 RocketMQ 提供的工具来验证安装是否成功。

5.1 发送消息
  1. bin 目录中,使用以下命令发送一条测试消息:
    tools.cmd org.apache.rocketmq.example.quickstart.Producer
    
  2. 这将发送一条消息到默认的 TopicTest
5.2 接收消息
  1. bin 目录中,使用以下命令接收测试消息:
    tools.cmd org.apache.rocketmq.example.quickstart.Consumer
    
  2. 如果消费者成功接收到消息,则表示 RocketMQ 安装和配置成功。

6. 使用控制台管理 RocketMQ

你可以选择安装 RocketMQ 控制台工具来更方便地管理和监控 RocketMQ 集群。

6.1 下载并启动 RocketMQ 控制台
  1. 从 GitHub 下载 RocketMQ 控制台。
  2. 使用以下命令启动控制台:
    java -jar rocketmq-console-ng-xxxx.jar --server.port=8080 --rocketmq.config.namesrvAddr=127.0.0.1:9876
    
  3. 启动后,打开浏览器访问 http://localhost:8080,你就可以通过图形化界面管理 RocketMQ。

这样,RocketMQ 就已经在 Windows 上成功安装并运行了。

3.SpringBoot集成RocketMQ

1.创建项目

在 IntelliJ IDEA 中创建一个 Spring Boot 项目很简单:选择 “新建项目”,然后选取 “Spring Initializr”;填写项目的基本信息如 Group 和 Artifact ID,选择 Java 版本和构建工具;添加所需的 Spring Boot Starter 依赖;最后选择项目位置并点击 “下一步” 完成创建。
在这里插入图片描述
后面仅选择Spring Web依赖后点击创建即可!
这里需要注意,如果创建项目后发现maven依赖始终无法下载下来,可以选择打开cmd终端,输入命令

where mvn

在这里插入图片描述
之后根据maven的路径,找到对应的conf下的setting.xml配置文件中更换镜像源地址,具体如下:

	<mirror>
		<id>alimaven</id>
		<name>aliyun maven</name>
		<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        <mirrorOf>central</mirrorOf>        
    </mirror>

在这里插入图片描述

2.引入依赖

首先,在你的pom.xml中添加RocketMQ的依赖,具体如下所示:

		<dependency>
            <groupId>org.apache.rocketmq</groupId>
            <artifactId>rocketmq-spring-boot-starter</artifactId>
            <version>2.2.0</version>
        </dependency>

3.配置文件

在``application.properties`中添加RocketMQ的基本配置:

spring.application.name=rocketmq-demo

rocketmq.nameServer=127.0.0.1:9876
rocketmq.producer.group=producer-group
rocketmq.consumer.group=consumer-group

4.创建消息生产者

创建一个 RocketMQProducer 类,包含三种消息发送方式:同步发送、异步发送和单向发送。

import org.apache.rocketmq.client.producer.SendCallback;
import org.apache.rocketmq.client.producer.SendResult;
import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.messaging.support.MessageBuilder;
import org.springframework.stereotype.Service;

@Service
public class RocketMQProducer {
    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    private final String topic = "demo-topic";

    // 1.同步发送消息
    public void sendSyncMessage(String message){
        rocketMQTemplate.syncSend(topic, MessageBuilder.withPayload(message).build());
        System.out.printf("同步发送结果: %s\n", message);
    }

    // 2.异步发送消息
    public void sendAsyncMessage(String message){
        rocketMQTemplate.asyncSend(topic, MessageBuilder.withPayload(message).build(), new SendCallback() {

            @Override
            public void onSuccess(SendResult sendResult) {
                System.out.printf("异步发送成功: %s\n", sendResult);
            }

            @Override
            public void onException(Throwable throwable) {
                System.out.printf("异步发送失败: %s\n", throwable.getMessage());
            }
        });
    }

    // 3.单向发送消息
    public void sendOneWayMessage(String message){
        rocketMQTemplate.sendOneWay(topic, MessageBuilder.withPayload(message).build());
        System.out.println("单向消息发送成功");
    }
}

5.创建消息消费者

接下来,创建一个 RocketMQConsumer 类来处理消费消息的逻辑。

import org.apache.rocketmq.spring.annotation.MessageModel;
import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

@Service
@RocketMQMessageListener(topic = "demo-topic", consumerGroup = "consumer-group", messageModel = MessageModel.CLUSTERING)
public class RocketMQConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String s) {
        System.out.printf("收到消息: %s\n", s);
    }
}

6.测试消息发送

编写一个简单的RocketController控制器,用于触发消息发送!

import com.xing.rocketmqdemo.service.RocketMQProducer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class RocketController {
    @Autowired
    private RocketMQProducer rocketMQProducer;

    @GetMapping("/sendSync")
    public String sendSync(@RequestParam String message) {
        rocketMQProducer.sendSyncMessage(message);
        return "同步消息发送成功";
    }

    @GetMapping("/sendAsync")
    public String sendAsync(@RequestParam String message) {
        rocketMQProducer.sendAsyncMessage(message);
        return "异步消息发送中";
    }

    @GetMapping("/sendOneWay")
    public String sendOneWay(@RequestParam String message) {
        rocketMQProducer.sendOneWayMessage(message);
        return "单向消息发送成功";
    }
}

7.启动项目并测试

启动你的 Spring Boot 应用程序,并通过浏览器或工具(如 Postman)访问以下 URL 来测试不同的消息发送方式:

  • 同步发送消息:http://localhost:8080/sendSync?message=HelloSync
  • 异步发送消息:http://localhost:8080/sendAsync?message=HelloAsync
  • 单向发送消息:http://localhost:8080/sendOneWay?message=HelloOneWay

8.解决问题

如果你出现类似以下的报错

***************************
APPLICATION FAILED TO START
***************************

Description:

Field rocketMQTemplate in com.xing.rocketmqdemo.service.RocketMQProducer required a bean of type 'org.apache.rocketmq.spring.core.RocketMQTemplate' that could not be found.

The injection point has the following annotations:
	- @org.springframework.beans.factory.annotation.Autowired(required=true)


Action:

Consider defining a bean of type 'org.apache.rocketmq.spring.core.RocketMQTemplate' in your configuration.

可参考解决:

  1. application.properties配置文件中添加生产者组的配置
    rocketmq.producer.group=producer-group

  2. 解决SpringBoot 3 + RocketMQ 配置不生效的问题
    具体可参考以下博客:
    https://kunyuan.tech/archives/366
    https://github.com/apache/rocketmq-spring/pull/541

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2059192.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

docker连接宿主机redis,提示Connection refused

目录 一、测试环境 二、问题现象 三、问题总结 一、测试环境 centos 7 redis-5.0.14 docker-26.0.1 二、问题现象 服务器重启后docker连接宿主机redis&#xff0c;提示Connection refused Reconnecting, last destination was /172.25.xxx.x:6379 …

4种回收站数据恢复方法,让数据快速恢复!

回收站里的重要数据怎么突然就消失得无影无踪了&#xff1f;别慌&#xff01;别慌&#xff01;在这里&#xff0c;为您精心准备了4种回收站数据恢复方法&#xff0c;这五种回收站数据恢复方法都是经过实际测试的&#xff0c;完全可以帮我们找回那些被删除的数据&#xff01; 回…

高杰:远程工作8年,平衡了工作与生活,但仍然对收入感到焦虑

这是《开发者说》的第14期&#xff0c;本期我们邀请的开发者是高杰&#xff0c;毕业于上海交大&#xff0c;因拆迁搬家到了郊区&#xff0c;忍受不了长时间的通勤&#xff0c;开始走上远程工作的道路&#xff0c;至今从事远程开发8年有余&#xff0c;他应该是国内最早从事远程工…

C语言提高(2)

calloc void *calloc(size_t namber&#xff0c;size_t size); 功能&#xff1a;在内存动态存储区中分配namber块长度为size字节的连续区域。calloc自动将分配的内存置0 namber&#xff1a;所需内存单元数量 size&#xff1a;每个内存单元的大小&#xff08;单位&#xff1a;字…

第二证券:融券余额,较历史高位下降逾九成!

在多种要素归纳影响下&#xff0c;近年融券余额和转融券余额持续下降&#xff0c;其间融券余额已较前史高位下降逾九成&#xff0c;而转融券余额年内降幅也已逾越九成。 有专家在接受证券时报记者采访时认为&#xff0c;融券和转融券余额大幅减少减轻了商场兜销压力&#xff0…

OV SSL证书:让您的网站与众不同

在当今高度竞争的数字世界中&#xff0c;拥有一个安全、可信的网站对于吸引和保留客户至关重要。组织验证&#xff08;OV&#xff09;SSL证书不仅可以为网站提供强大的加密保护&#xff0c;还能通过验证组织的真实身份来增强用户的信任感。本文将探讨OV SSL证书如何帮助您的网站…

背包问题有前提

前言&#xff1a;这个有大前提的背包感觉不能用二进制拆分&#xff0c;不然搞不清楚 注意三维的顺便&#xff0c;第一维度是枚举物品&#xff0c;第二维度是倒序枚举空间&#xff0c;第三维度是枚举数量 题目地址 #include<bits/stdc.h> using namespace std;#define …

XSS-Jquery.html()+DOM破坏

目录 靶场网址&#xff1a;​ https://xss.pwnfunction.com/challenges/ww3/ ​ 分析代码&#xff1a; Jquery.html()解析原理&#xff1a; DOM-clobbering JS作用域&作用域链 ​编辑 靶场网址&#xff1a;​ https://xss.pwnfunction.com/challenges/ww3/ ​ 分析代…

全液冷服务器革命:CPU、内存、PCIe高效散热新方案

在国家十四五规划大力发展数字经济的背景下&#xff0c;数据中心作为算力的核心载体&#xff0c;其基础设施成为支撑数字经济的“数字底座”&#xff0c;但同时也面临巨大的碳排放压力。随着芯片与服务器功耗的上升&#xff0c;单机柜功率密度不断增大&#xff0c;传统风冷散热…

RF自动化环境安装+自动化实例解析

RF定义&#xff1a; 通用型的 自动测试框架&#xff0c; 绝大部分的软件的的自动化系统都可以采用它。 特点&#xff1a; 测试数据文件&#xff08;Test Data&#xff09;对应一个个的测试用例。测试数据文件里面使用的功能小模块叫关键字&#xff0c;由测试库&#xff08;T…

【生日视频制作】教师节中秋节国庆节红色直升飞机AE模板修改文字软件生成器教程特效素材【AE模板】

红色直升飞机生日视频制作教程AE模板改文字广软件告生成器素材 怎么如何做的【生日视频制作】教师节中秋节国庆节红色直升飞机AE模板修改文字软件生成器教程特效素材【AE模板】 生日视频制作步骤&#xff1a; 安装AE软件下载AE模板把AE模板导入AE软件修改图片或文字渲染出视频…

字节跳远,AI绘梦:我的自由之旅,从编码到画布的奇幻转变

一、告别字节&#xff0c;开启未知旅程 在字节跳动的那些日子里&#xff0c;我经历了职场的起伏&#xff0c;也见证了公司的飞速发展。然而&#xff0c;高强度的工作节奏和不断攀升的业绩压力&#xff0c;让我开始思考生活的意义。最终&#xff0c;我做出了一个大胆的决定——裸…

Leetcode面试经典150题-300.最长递增子序列

解法都在代码里&#xff0c;不懂就留言或者私信 面试的话普通的动态规划解法就够了&#xff0c;如果要出彩&#xff0c;看看我提交的最终的解 class Solution {/**解题思路分析&#xff1a;这个题的普通解法是标准的动态规划对于每一个位置的值&#xff0c;看看前面所有的比它…

[数据集][目标检测]流水线物件检测数据集VOC+YOLO格式9255张26类别

数据集格式&#xff1a;Pascal VOC格式YOLO格式(不包含分割路径的txt文件&#xff0c;仅仅包含jpg图片以及对应的VOC格式xml文件和yolo格式txt文件) 图片数量(jpg文件个数)&#xff1a;9255 标注数量(xml文件个数)&#xff1a;9255 标注数量(txt文件个数)&#xff1a;9255 标注…

分析Facebook在区块链技术中的应用与前景

随着数字技术的飞速发展&#xff0c;区块链作为一种具有去中心化、安全性高、透明度强等特点的技术&#xff0c;逐渐引起了各大科技公司的关注。Facebook&#xff08;现Meta&#xff09;也不例外&#xff0c;其在区块链技术上的探索不仅显示了对未来技术趋势的敏锐洞察&#xf…

周易测算系统开发:融合古典智慧与现代技术的创新实践

一、引言 周易&#xff0c;作为中国古代文化的瑰宝&#xff0c;蕴含着深邃的哲学思想与预测智慧&#xff0c;其独特的六十四卦体系及爻变原理&#xff0c;自古以来便被人们用于探索自然规律、人生哲理及未来趋势。随着科技的飞速发展&#xff0c;将周易智慧与现代计算机技术相结…

虚幻5|AI行为树,跟随task(非行为树AI)

这个可以不需要行为树 1.打开ai的角色蓝图后&#xff0c;添加一个函数&#xff0c;命名为跟距离改变速度 并用tick调用 2.编辑函数

python实现自动化生成pdf报告

easypdf使用手册 1. 项目介绍1.1 关于1.2 easypdf 有什么优势1.2 easypdf 可以用来做什么1.3 项目框架1.4 项目教程视频 2. 安装项目环境2.1 安装Python32.2在Windows上安装Python32.3 在Mac上安装Python32.4 在Linux上安装Python32.5 在Windows上安装Pycharm2.6 在Mac上安装Py…

Funsound语音识别技术之 基于paraformer的自定义命令(唤醒)词识别

免费语音识别转写&#xff08;优于讯飞&#xff09;&#xff1a;www.funsound.cn 前言 Paraformer在声学后验上通过greedy search得到语音识别结果&#xff0c;对于自定义命令&#xff08;唤醒&#xff09;词识别&#xff0c;肯定还得走asr模型。对此我们可以在paraformer上为…

基于Java爬取微博数据(五) 补充微博正文列表图片 or 视频 内容

基于Java爬取微博数据五 补充微博正文列表图片 or 视频 内容 数据分析补充图片 or 视频执行结果 在通过对微博正文内容中的图片 or 视频内容进行分析后&#xff0c;图片 or 视频 链接是可以直接通过 Java 代码下载或者转存的&#xff0c;那么这样就可以补充我们在 【基于Java爬…