Bootstrap

Spring Cloud Alibaba 快速学习之 RocketMQ

1 引言

RocketMQ 是一款开源的分布式消息系统,基于高可用分布式集群技术,提供低延时的、高可靠的消息发布与订阅服务。同时,广泛应用于多个领域,包括异步通信解耦、企业解决方案、金融支付、电信、电子商务、快递物流、广告营销、社交、即时通信、移动应用、手游、视频、物联网、车联网等。

2 下载安装

2.1 下载 RocketMQ

打开下载地址,下载zip文件,并解压到任意位置。
在这里插入图片描述解压后的目录结构如下:
在这里插入图片描述

2.2 配置环境变量

配置环境变量ROCKETMQ_HOME,值是解压目录。
未配置时,启动可能会报错:Please set the ROCKETMQ_HOME variable in your environment!。
在这里插入图片描述在这里插入图片描述

2.3 修改配置文件

  • 记事本打开bin/runserver.cmd文件。
  • 指定JDK为1.8。RocketMQ默认使用jdk1.8,没有请下载一个。
  • 修改启动内存。根据自己电脑配置修改即可。
    在这里插入图片描述
set JAVA_HOME=D:\Program Files\JDK\jdk8
set "JAVA_OPT=%JAVA_OPT% -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
  • 直接记事本打开bin/runbroker.cmd文件。
  • 指定JDK为1.8。RocketMQ默认使用jdk1.8,没有请下载一个。
  • 修改启动内存。根据自己电脑配置修改即可。
    在这里插入图片描述
set JAVA_HOME=D:\Program Files\JDK\jdk8
set "JAVA_OPT=%JAVA_OPT% -server -Xms256m -Xmx256m -Xmn128m"

2.4 启动RocketMQ

切换到bin目录下:输入.\mqnamesrv.cmd启动NameServer。
在这里插入图片描述切换到bin目录下:输入.\mqbroker.cmd -n localhost:9876启动Broker。
在这里插入图片描述

3 创建项目

创建一个名为spring-cloud-alibaba-demo的项目作为父级项目,使用Maven+JDK17。不会的请看IntelliJ IDEA快速创建Spring Boot项目。再创建三个子项目(Module)分别名为rocketmq-consumer-a、rocketmq-consumer-b、rocketmq-producer。最终项目结构,如下图。
在这里插入图片描述

3.1 父项目spring-cloud-alibaba-demo

父级项目,用于管理公用的依赖,本项目只有一个pom.xml文件。
在这里插入图片描述

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>spring-cloud-alibaba-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>rocketmq-producer</module>
        <module>rocketmq-consumer-a</module>
        <module>rocketmq-consumer-b</module>
    </modules>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!--  为Spring Boot项目提供一系列默认的配置和依赖管理-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.2</version>
        <relativePath/>
    </parent>

    <dependencies>
        <!--  Spring Boot核心-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!-- Spring Boot单元测试和集成测试-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- Spring Boot构建Web应用程序-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

    </dependencies>

</project>

3.2 子项目rocketmq-consumer-a

该项目有三个文件,从下往上列出。用于测试接收消息。
在这里插入图片描述

  • pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.example</groupId>
        <artifactId>spring-cloud-alibaba-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>rocketmq-consumer-a</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- spring cloud alibaba RocketMQ集成-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-stream-rocketmq</artifactId>
            <version>2023.0.1.2</version>
        </dependency>
    </dependencies>

</project>
  • application.properties
    注意testchannel-out-0中的testchannel是通道名称,生产者和消费者的配置文件中须保持一致。
#spring应用程序监听的端口号
server.port=8081
#spring应用程序的名称
spring.application.name=rocketmq-consumer-b
#spring当前激活的配置文件
spring.profiles.active=dev

#rocketmq 服务地址
spring.cloud.stream.rocketmq.binder.name-server=localhost:9876
#rocketmq 接受消息的方法名,须保持与通道名一致
spring.cloud.stream.function.definition=testchannel
# 通道接收广播消息
spring.cloud.stream.rocketmq.bindings.testchannel-in-0.consumer.messageModel=BROADCASTING

#rocketmq 通道分组
spring.cloud.stream.bindings.testchannel-in-0.group=test-group
#rocketmq 通道目标
spring.cloud.stream.bindings.testchannel-in-0.destination=test-destination
#rocketmq 通道消息类型
spring.cloud.stream.bindings.testchannel-in-0.content-type=application/json
  • org/example/MainRocketMQConsumerA.java
package org.example;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.messaging.Message;

import java.util.Map;
import java.util.function.Consumer;

@SpringBootApplication
public class MainRocketMQConsumerA {

    public static void main(String[] args) {
        SpringApplication.run(MainRocketMQConsumerA.class, args);
    }


    @Bean
    public Consumer<Message<Map<String, String>>> testchannel() {
        return msg -> {
            System.out.println("rocketmq-consumer-a Receive New Messages: " + msg.toString());
        };
    }

}

3.3 子项目rocketmq-consumer-b

该项目有三个文件,从下往上列出。用于测试接收消息。
在这里插入图片描述

  • pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.example</groupId>
        <artifactId>spring-cloud-alibaba-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>rocketmq-consumer-b</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- spring cloud alibaba RocketMQ集成-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-stream-rocketmq</artifactId>
            <version>2023.0.1.2</version>
        </dependency>
    </dependencies>

</project>
  • application.properties
    注意testchannel-out-0中的testchannel是通道名称,生产者和消费者的配置文件中须保持一致。
#spring应用程序监听的端口号
server.port=8082
#spring应用程序的名称
spring.application.name=rocketmq-consumer-b
#spring当前激活的配置文件
spring.profiles.active=dev

#rocketmq 服务地址
spring.cloud.stream.rocketmq.binder.name-server=localhost:9876
#rocketmq 接受消息的方法名,须保持与通道名一致
spring.cloud.stream.function.definition=testchannel
# 通道接收广播消息
spring.cloud.stream.rocketmq.bindings.testchannel-in-0.consumer.messageModel=BROADCASTING

#rocketmq 通道分组
spring.cloud.stream.bindings.testchannel-in-0.group=test-group
#rocketmq 通道目标
spring.cloud.stream.bindings.testchannel-in-0.destination=test-destination
#rocketmq 通道消息类型
spring.cloud.stream.bindings.testchannel-in-0.content-type=application/json






  • org/example/MainRocketMQConsumerB.java
package org.example;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.messaging.Message;

import java.util.Map;
import java.util.function.Consumer;

@SpringBootApplication
public class MainRocketMQConsumerB {

    public static void main(String[] args) {
        SpringApplication.run(MainRocketMQConsumerB.class, args);
    }

    @Bean
    public Consumer<Message<Map<String, String>>> testchannel() {
        return msg -> {
            System.out.println("rocketmq-consumer-b Receive New Messages: " + msg.toString());
        };
    }

}

3.4 子项目rocketmq-producer

该项目有四个文件,从下往上列出。用于测试发送消息。
在这里插入图片描述 - pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.example</groupId>
        <artifactId>spring-cloud-alibaba-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>rocketmq-producer</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- spring cloud alibaba RocketMQ集成-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-stream-rocketmq</artifactId>
            <version>2023.0.1.2</version>
        </dependency>
    </dependencies>

</project>
  • application.properties
    注意testchannel-out-0中的testchannel是通道名称,生产者和消费者的配置文件中须保持一致。
#spring应用程序监听的端口号
server.port=8080
#spring应用程序的名称
spring.application.name=rocketmq-producer
#spring当前激活的配置文件
spring.profiles.active=dev

#rocketmq 服务地址
spring.cloud.stream.rocketmq.binder.name-server=localhost:9876
#rocketmq 通道分组
spring.cloud.stream.bindings.testchannel-out-0.producer.group=test-group
#rocketmq 通道目标
spring.cloud.stream.bindings.testchannel-out-0.destination=test-destination
#rocketmq 通道消息类型
spring.cloud.stream.bindings.testchannel-out-0.content-type=application/json

  • org/example/MainRocketMQProducer.java
package org.example;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MainRocketMQProducer {

    public static void main(String[] args) {
        SpringApplication.run(MainRocketMQProducer.class, args);
    }

}

  • org/example/controller/TestController.java
package org.example.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cloud.stream.function.StreamBridge;
import org.springframework.integration.support.MessageBuilder;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;


@RestController
@RequestMapping("/test")
public class TestController {

    @Autowired
    private StreamBridge streamBridge;

    @GetMapping("/send")
    public String send() {
        for (int i = 0; i < 50; i++) {
            Map<String, String> map = new HashMap<>();
            String id = i + "";
            map.put("id", id);
            map.put("msg", "测试消息");
            MessageBuilder<Map<String, String>> builder = MessageBuilder.withPayload(map);
            boolean send = streamBridge.send("testchannel-out-0", builder.build());
            System.out.println("消息" + id + ",发送状态:" + send);
        }
        return "消息发送成功!";
    }


}

4 测试项目

4.1 同时启动三个子项目

在这里插入图片描述

4.2 发送消息

打开浏览器访问:http://localhost:8080/test/send,这里简单的发送广播消息。在这里插入图片描述

4.3 查看消息

分别查看三个项目的控制台,可以看到消息发送和接收的日志,与代码功能一致,说明RocketMQ初步测试通过。
在这里插入图片描述在这里插入图片描述
在这里插入图片描述

;