一文详解RocketMQ-Spring的源码解析与实战

摘要:这篇文章主要介绍 Spring Boot 项目使用 rocketmq-spring SDK 实现消息收发的操作流程,同时笔者会从开发者的角度解读 SDK 的设计逻辑。

本文分享自华为云社区《RocketMQ-Spring : 实战与源码解析一网打尽》,作者:勇哥java实战分享。

RocketMQ 是大家耳熟能详的消息队列,开源项目 rocketmq-spring 可以帮助开发者在 Spring Boot 项目中快速整合 RocketMQ。

这篇文章会介绍 Spring Boot 项目使用 rocketmq-spring SDK 实现消息收发的操作流程,同时笔者会从开发者的角度解读 SDK 的设计逻辑。

一文详解RocketMQ-Spring的源码解析与实战

一 SDK 简介

一文详解RocketMQ-Spring的源码解析与实战

项目地址:https://github.com/apache/rocketmq-spring

rocketmq-spring 的本质是一个 Spring Boot starter 。

Spring Boot 基于“约定大于配置”(Convention over configuration)这一理念来快速地开发、测试、运行和部署 Spring 应用,并能通过简单地与各种启动器(如 spring-boot-web-starter)结合,让应用直接以命令行的方式运行,不需再部署到独立容器中。

Spring Boot starter 构造的启动器使用起来非常方便,开发者只需要在 pom.xml 引入 starter 的依赖定义,在配置文件中编写约定的配置即可。

下面我们看下 rocketmq-spring-boot-starter 的配置:

1、引入依赖

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

2、约定配置

一文详解RocketMQ-Spring的源码解析与实战

接下来,我们分别按照生产者和消费者的顺序,详细的讲解消息收发的操作过程。

二 生产者

首先我们添加依赖后,进行如下三个步骤:

1、配置文件中配置如下

rocketmq:
  name-server: 127.0.0.1:9876
  producer:
      group: platform-sms-server-group
    # access-key: myaccesskey
    # secret-key: mysecretkey
  topic: sms-common-topic

生产者配置非常简单,主要配置名字服务地址和生产者组。

2、需要发送消息的类中注入 RcoketMQTemplate

@Autowired
private RocketMQTemplate rocketMQTemplate;
​
@Value("${rocketmq.topic}")
private String smsTopic;

3、发送消息,消息体可以是自定义对象,也可以是 Message 对象

rocketMQTemplate 类包含多钟发送消息的方法:

  1. 同步发送 syncSend
  2. 异步发送 asyncSend
  3. 顺序发送 syncSendOrderly
  4. oneway发送 sendOneWay

下面的代码展示如何同步发送消息。

String destination = StringUtils.isBlank(tags) ? topic : topic + ":" + tags;
SendResult sendResult =
 rocketMQTemplate.syncSend(
            destination, 
 MessageBuilder.withPayload(messageContent).
 setHeader(MessageConst.PROPERTY_KEYS, uniqueId).
 build()
 );
if (sendResult != null) {
 if (sendResult.getSendStatus() == SendStatus.SEND_OK) {
 // send message success ,do something 
 }
}

syncSend 方法的第一个参数是发送的目标,格式是:topic + ":" + tags ,

第二个参数是:spring-message 规范的 message 对象 ,而 MessageBuilder 是一个工具类,方法链式调用创建消息对象。

三 消费者

1、配置文件中配置如下

rocketmq:
  name-server: 127.0.0.1:9876
  consumer1:
    group: platform-sms-worker-common-group
    topic: sms-common-topic

2、实现消息监听器

@Component
@RocketMQMessageListener(
 consumerGroup = "${rocketmq.consumer1.group}", //消费组
    topic = "${rocketmq.consumer1.topic}" //主题
)
public class SmsMessageCommonConsumer implements RocketMQListener<String> {
 public void onMessage(String message) {
 System.out.println("普通短信:" + message);
 }
}

消费者实现类也可以实现 RocketMQListener<MessageExt>, 在 onMessage 方法里通过 RocketMQ 原生消息对象 MessageExt 获取更详细的消息数据 。

public void onMessage(MessageExt message) {
 try {
        String body = new String(message.getBody(), "UTF-8");
        logger.info("普通短信:" + message);
 } catch (Exception e) {
 logger.error("common onMessage error:", e);
 }
}

四 源码概览

一文详解RocketMQ-Spring的源码解析与实战

最新源码中,我们可以看到源码中包含四个模块:

1、rocketmq-spring-boot-parent

该模块是父模块,定义项目所有依赖的 jar 包。

2、rocketmq-spring-boot

核心模块,实现了 starter 的核心逻辑。

3、rocketmq-spring-boot-starter

SDK 模块,简单封装,外部项目引用。

4、rocketmq-spring-boot-samples

示例代码模块。这个模块非常重要,当用户使用 SDK 时,可以参考示例快速开发。

五 starter 实现

我们重点分析下 rocketmq-spring-boot 模块的核心源码:

一文详解RocketMQ-Spring的源码解析与实战

spring-boot-starter 实现需要包含如下三个部分:

1、定义 Spring 自身的依赖包和 RocketMQ 的依赖包 ;

2、定义spring.factories 文件

在 resources 包下创建 META-INF 目录后,新建 spring.factories 文件,并在文件中定义自动加载类,文件内容是:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.apache.rocketmq.spring.autoconfigure.RocketMQAutoConfiguration

spring boot 会根据文件中配置的自动化配置类来自动初始化相关的 Bean、Component 或 Service。

3、实现自动加载类

在 RocketMQAutoConfiguration 类的具体实现中,我们重点分析下生产者和消费者是如何分别启动的。

▍生产者发送模板类:RocketMQTemplate

RocketMQAutoConfiguration 类定义了两个默认的 Bean :

一文详解RocketMQ-Spring的源码解析与实战一文详解RocketMQ-Spring的源码解析与实战

首先SpringBoot项目中配置文件中的配置值会根据属性条件绑定到 RocketMQProperties 对象 中,然后使用 RocketMQ 的原生 API 分别创建生产者 Bean 和拉取消费者 Bean , 分别将两个 bean 设置到 RocketMQTemplate 对象中。

两个重点需要强调:

  • 发送消息时,将 spring-message 规范下的消息对象封装成 RocketMQ 消息对象

一文详解RocketMQ-Spring的源码解析与实战

  • 默认拉取消费者 litePullConsumer 。拉取消费者一般用于大数据批量处理场景 。

一文详解RocketMQ-Spring的源码解析与实战

RocketMQTemplate 类封装了拉取消费者的receive方法,以方便开发者使用。

一文详解RocketMQ-Spring的源码解析与实战

▍自定义消费者类

下图是并发消费者的例子:

一文详解RocketMQ-Spring的源码解析与实战

那么 rocketmq-spring 是如何自动启动消费者呢 ?

一文详解RocketMQ-Spring的源码解析与实战

spring 容器首先注册了消息监听器后置处理器,然后调用 ListenerContainerConfiguration 类的 registerContainer 方法 。

对比并发消费者的例子,我们可以看到: DefaultRocketMQListenerContainer 是对 DefaultMQPushConsumer 消费逻辑的封装。

一文详解RocketMQ-Spring的源码解析与实战

封装消费消息的逻辑,同时满足 RocketMQListener 泛化接口支持不同参数,比如 String 、MessageExt 、自定义对象 。

首先DefaultRocketMQListenerContainer初始化之后, 获取 onMessage 方法的参数类型 。

一文详解RocketMQ-Spring的源码解析与实战

然后消费者调用 consumeMessage 处理消息时,封装了一个 handleMessage 方法 ,将原生 RocketMQ 消息对象 MessageExt 转换成 onMessage 方法定义的参数对象,然后调用 rocketMQListener 的 onMessage 方法。

一文详解RocketMQ-Spring的源码解析与实战

上图右侧标红的代码也就是该方法的精髓:

rocketMQListener.onMessage(doConvertMessage(messageExt));

六 写到最后

开源项目 rocketmq-spring 有很多值得学习的地方 ,我们可以从如下四个层面逐层进阶:

1、学会如何使用 :参考 rocketmq-spring-boot-samples 模块的示例代码,学会如何发送和接收消息,快速编码;

2、模块设计:学习项目的模块分层 (父模块、SDK 模块、核心实现模块、示例代码模块);

3、starter 设计思路 :定义自动配置文件 spring.factories 、设计配置属性类 、在 RocketMQ client 的基础上实现优雅的封装、深入理解 RocketMQ 源码等;

4、举一反三:当我们理解了 rocketmq-spring 的源码,我们可以尝试模仿该项目写一个简单的 spring boot starter。

 

点击关注,第一时间了解华为云新鲜技术~

原文链接:https://www.cnblogs.com/huaweiyun/p/17349393.html

本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:一文详解RocketMQ-Spring的源码解析与实战 - Python技术站

(0)
上一篇 2023年4月25日
下一篇 2023年4月25日

相关文章

  • Java8 新特性之日期时间对象及一些其他特性

    Java8 新特性之日期时间对象及一些其他特性 为什么需要新的日期时间API? 在Java 7之前,我们使用的日期时间API(java.util.Date和java.util.Calendar)存在几个问题: 非线程安全:在多线程环境下,如果多个线程同时操作日期时间对象,容易出现错误。 可变类型:java.util.Date和java.util.Calend…

    Java 2023年5月20日
    00
  • MyBatis入门学习教程-MyBatis快速入门

    对于”MyBatis入门学习教程-MyBatis快速入门”,我们可以按照如下步骤来进行学习,包括环境搭建、对象映射、CRUD操作等内容。 一、环境搭建 下载MyBatis在MyBatis的官方网站上下载最新版本的MyBatis(https://github.com/mybatis/mybatis-3/releases),解压后将其中的mybatis-3.x.…

    Java 2023年5月20日
    00
  • C#如何连接使用Zookeeper

    下面我将详细讲解C#如何连接使用ZooKeeper的完整攻略。 什么是ZooKeeper ZooKeeper是一个开源的分布式协调服务,可以提供数据管理、分布式锁、集群管理等功能,特别适合用于协调分布式系统中各个节点的通信。 在C#中使用ZooKeeper 安装ZooKeeper NuGet包 首先,我们需要在C#项目中引入ZooKeeper NuGet包,…

    Java 2023年5月19日
    00
  • Java日常练习题,每天进步一点点(44)

    Java日常练习题,每天进步一点点(44)的完整攻略如下: 1. 题目描述: 这个题目是要求实现一个算法,在一个有序的数组中查找某个元素是否存在,并返回它在数组中的索引值,如果不存在就返回-1。 2. 题目思路: 适用于有序数组的查找算法有很多种,但是考虑到题目本身要求我们返回元素在数组中的索引值,我们最好使用二分查找算法(Binary Search Alg…

    Java 2023年5月20日
    00
  • 基于Ajax+div的“左边菜单、右边内容”页面效果实现

    “基于Ajax+div的‘左边菜单、右边内容’页面效果实现”是现代web前端开发中常用的技术之一,利用该技术可以实现Web应用程序的异步局部更新,提升用户体验。实现该效果的主要步骤包括以下内容: 步骤一:设计页面结构 该效果的实现主要依赖于HTML页面布局的正确实现。需要创建两个区域:左边菜单和右边内容区域。左边菜单区域需要部署一组链接,点击每个链接时,右边…

    Java 2023年6月15日
    00
  • mybatis的mapper.xml中resultMap标签的使用详解

    下面我将详细讲解MyBatis的Mapper XML中resultMap标签的使用详解。 1. result标签和resultMap标签的区别 在MyBatis中,通过 select 元素的 resultType 或 resultMap 属性指定查询结果的映射方式。其中, resultType 属性可通过 JavaBean 对象或基本数据类型指定映射方式,它…

    Java 2023年5月19日
    00
  • jsvascript图像处理—(计算机视觉应用)图像金字塔

    JavaScript图像处理-图像金字塔 简介 图像金字塔是一种由同一图像的多个分辨率构成的数据结构。每一层的大小是前一层的一半,高频信息(细节)被过滤,低频信息(谐波)被保留。 图像金字塔的主要应用包括: 缩放图片 图像分割 特征提取 增强图像 处理流程 对于每一层的金字塔图像,可以通过下采样(up-sampling)和高斯卷积(Gauss blur)来实…

    Java 2023年6月15日
    00
  • Java中关于char类型变量能够输出中文的问题

    Java中的char类型变量能够输出中文,是因为Java使用的是Unicode字符编码标准,其中全球所有的字符都有唯一的码位,包括中文字符。在Java中,char类型变量以16位无符号整数形式存储字符。由于Unicode字符集在编码范围内包含了中文字符,所以Java的char类型变量和String类型能将中文字符完美输出。 在Java中,对于char类型变量…

    Java 2023年5月26日
    00
合作推广
合作推广
分享本页
返回顶部