SpringBoot整合RocketMQ入门示例-rocketmq-spring-boot-starter

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

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就是取的数组的第二个。