SpringBoot整合RocketMQ入门示例

环境：springboot2.3.9 + RocketMQ4.8.0

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服务器拉取消息、并将其提供给应用程序。从用户应用的云南idc服务商角度而言提供了两种消费形式：拉取式消费、推动式消费。

4 主题(Topic)

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

5 代理服务器(Broker Server)

消息中转角色，负责存储消息、转发消息。代理服务器在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对比：

RocketMQ服务

1 下载RocketMQ

2 配置环境变量

3 启动Name Server

4 启动 Broker

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

设置环境变量：

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

发送消息：

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

接收消息：

SpringBoot整合RocketMQ入门

依赖：

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

配置文件：

rocketmq:   nameServer: localhost:9876   producer:     group: demo-mq 

生产者：

@Service public class ProducerService {      @Resource     private RocketMQTemplate rocketMQTemplate ;     public void send(String message) {          rocketMQTemplate.convertAndSend("test-topic", message);     } } 

消费者：

@RocketMQMessageListener(topic = "test-topic", consumerGroup = "consumer01-group") @Component public class ConsumerListener implements RocketMQListener<String> {      @Override     public void onMessage(String message) {          System.out.println("接收到消息：" + message) ;     } } 

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

发送接口:

@RestController @RequestMapping("/messages") public class MessageController {      @Resource     private ProducerService ps ;     @GetMapping("")     public Object send(String message) {          ps.send(message) ;         return "send success" ;     } } 

测试：

发送消息指定tags

发送时：

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

接收时：

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

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

这里看下源码：

RocketMQUtil.java

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