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初步测试通过。