SpringBoot整合RocketMQ入门示例

时间:2021-08-10 07:30:46

SpringBoot整合RocketMQ入门示例

环境:springboot2.3.9 + RocketMQ4.8.0

RocketMQ机构及概念

SpringBoot整合RocketMQ入门示例

1 消息模型(Message Model)

RocketMQ主要由 Producer、Broker、Consumer 三部分组成,其中Producer 负责生产消息,Consumer 负责消费消息,Broker 负责存储消息。Broker 在实际部署过程中对应一台服务器,每个 Broker 可以存储多个Topic的消息,每个Topic的消息也可以分片存储于不同的 Broker。Message Queue 用于存储消息的物理地址,每个Topic中的消息地址存储于多个 Message Queue 中。ConsumerGroup 由多个Consumer 实例构成。

2 消息生产者(Producer)

负责生产消息,一般由业务系统负责生产消息。一个消息生产者会把业务应用系统里产生的消息发送到broker服务器。RocketMQ提供多种发送方式,同步发送、异步发送、顺序发送、单向发送。同步和异步方式均需要Broker返回确认信息,单向发送不需要。

3 消息消费者(Consumer)

负责消费消息,一般是后台系统负责异步消费。一个消息消费者会从Broker服务器拉取消息、并将其提供给应用程序。从用户应用的角度而言提供了两种消费形式:拉取式消费、推动式消费。

4 主题(Topic)

表示一类消息的集合,每个主题包含若干条消息,每条消息只能属于一个主题,是RocketMQ进行消息订阅的基本单位。

5 代理服务器(Broker Server)

消息中转角色,负责存储消息、转发消息。代理服务器在RocketMQ系统中负责接收从生产者发送来的消息并存储、同时为消费者的拉取请求作准备。代理服务器也存储消息相关的元数据,包括消费者组、消费进度偏移和主题和队列消息等。如下图:

SpringBoot整合RocketMQ入门示例

6 名字服务(Name Server)

名称服务充当路由消息的提供者。生产者或消费者能够通过名字服务查找各主题相应的Broker IP列表。多个Namesrv实例组成集群,但相互独立,没有信息交换。

7 拉取式消费(Pull Consumer)

Consumer消费的一种类型,应用通常主动调用Consumer的拉消息方法从Broker服务器拉消息、主动权由应用控制。一旦获取了批量消息,应用就会启动消费过程。

8 推动式消费(Push Consumer)

Consumer消费的一种类型,该模式下Broker收到数据后会主动推送给消费端,该消费模式一般实时性较高。

9 生产者组(Producer Group)

同一类Producer的集合,这类Producer发送同一类消息且发送逻辑一致。如果发送的是事务消息且原始生产者在发送之后崩溃,则Broker服务器会联系同一生产者组的其他生产者实例以提交或回溯消费。

10 消费者组(Consumer Group)

同一类Consumer的集合,这类Consumer通常消费同一类消息且消费逻辑一致。消费者组使得在消息消费方面,实现负载均衡和容错的目标变得非常容易。要注意的是,消费者组的消费者实例必须订阅完全相同的Topic。RocketMQ 支持两种消息模式:集群消费(Clustering)和广播消费(Broadcasting)。

11 集群消费(Clustering)

集群消费模式下,相同Consumer Group的每个Consumer实例平均分摊消息。

12 广播消费(Broadcasting)

广播消费模式下,相同Consumer Group的每个Consumer实例都接收全量的消息。

13 普通顺序消息(Normal Ordered Message)

普通顺序消费模式下,消费者通过同一个消费队列收到的消息是有顺序的,不同消息队列收到的消息则可能是无顺序的。

14 严格顺序消息(Strictly Ordered Message)

严格顺序消息模式下,消费者收到的所有消息均是有顺序的。

15 消息(Message)

消息系统所传输信息的物理载体,生产和消费数据的最小单位,每条消息必须属于一个主题。RocketMQ中每个消息拥有唯一的Message ID,且可以携带具有业务标识的Key。系统提供了通过Message ID和Key查询消息的功能。

16 标签(Tag)

为消息设置的标志,用于同一主题下区分不同类型的消息。来自同一业务单元的消息,可以根据不同业务目的在同一主题下设置不同标签。标签能够有效地保持代码的清晰度和连贯性,并优化RocketMQ提供的查询系统。消费者可以根据Tag实现对不同子主题的不同消费逻辑,实现更好的扩展性。

ActiveMQ,Kafka,RocketMQ对比:

 

SpringBoot整合RocketMQ入门示例

RocketMQ服务

 

1 下载RocketMQ

SpringBoot整合RocketMQ入门示例

2 配置环境变量

SpringBoot整合RocketMQ入门示例

3 启动Name Server

SpringBoot整合RocketMQ入门示例

4 启动 Broker

SpringBoot整合RocketMQ入门示例

5 通过命令行发送 & 接收消息

设置环境变量:

  1. C:\Users\MSI-NB>set NAMESRV_ADDR=localhost:9876 

发送消息:

  1. C:\Users\MSI-NB>tools org.apache.rocketmq.example.quickstart.Producer 

SpringBoot整合RocketMQ入门示例

接收消息:

SpringBoot整合RocketMQ入门示例

SpringBoot整合RocketMQ入门

 

依赖:

  1. <dependency> 
  2.   <groupId>org.apache.rocketmq</groupId> 
  3.   <artifactId>rocketmq-spring-boot-starter</artifactId> 
  4.   <version>2.2.0</version> 
  5. </dependency> 

配置文件:

  1. rocketmq: 
  2.   nameServer: localhost:9876 
  3.   producer: 
  4.     group: demo-mq 

生产者:

  1. @Service 
  2. public class ProducerService { 
  3.      
  4.     @Resource 
  5.     private RocketMQTemplate rocketMQTemplate ; 
  6.      
  7.     public void send(String message) { 
  8.         rocketMQTemplate.convertAndSend("test-topic", message); 
  9.     } 
  10.      

消费者:

  1. @RocketMQMessageListener(topic = "test-topic", consumerGroup = "consumer01-group"
  2. @Component 
  3. public class ConsumerListener implements RocketMQListener<String> { 
  4.  
  5.     @Override 
  6.     public void onMessage(String message) { 
  7.         System.out.println("接收到消息:" + message) ; 
  8.     } 
  9.  

这里的topic要和发送端设置的一致,consumerGroup可随意。

发送接口:

  1. @RestController 
  2. @RequestMapping("/messages"
  3. public class MessageController { 
  4.      
  5.     @Resource 
  6.     private ProducerService ps ; 
  7.      
  8.     @GetMapping(""
  9.     public Object send(String message) { 
  10.         ps.send(message) ; 
  11.         return "send success" ; 
  12.     } 
  13.      

测试:

SpringBoot整合RocketMQ入门示例

SpringBoot整合RocketMQ入门示例

发送消息指定tags

发送时:

  1. rocketMQTemplate.convertAndSend("test-topic:tag1", message); 

接收时:

  1. @RocketMQMessageListener(topic = "test-topic", consumerGroup = "consumer01-group", selectorExpression = "tag1"

selectorExpression:默认是 “*” ,这里指定与发送的一致;

这里看下源码:

RocketMQUtil.java

SpringBoot整合RocketMQ入门示例

这里topic与tags是用冒号 ":" 分割的,tags就是取的数组的第二个。

原文地址:https://www.toutiao.com/i6944602891181244932/