RocketMQ 可视化环境搭建和基础代码使用

柔情只为你懂 2023-10-18 20:56 56阅读 0赞

RocketMQ 是一款分布式消息中间件，最初是由阿里巴巴消息中间件团队研发并大规模应用于生产系统，满足线上海量消息堆积的需求， 在 2016 年底捐赠给 Apache 开源基金会成为孵化项目，经过不到一年时间正式成为了 Apache 顶级项目。  
早期阿里曾经基于 ActiveMQ 研发消息系统， 随着业务消息的规模增大，瓶颈逐渐显现，后来也考虑过Kafka，但因为在低延迟和高可靠性方面没有选择，最后才自主研发了 RocketMQ， 各方面的性能都比目前已有的消息队列要好，RocketMQ 和 Kafka 在概念和原理上都非常相似，所以也经常被拿来对比；RocketMQ 默认采用长轮询的拉模式， 单机支持千万级别的消息堆积，可以非常好的应用在海量消息系统中。  
本文分为三部分，如下图所示：  
![image.png][]

### 1 安装 RocketMQ—Windows 版本 ###

#### （1）下载 Windows 安装包 ####

Windows 版本下载地址：[http://rocketmq.apache.org/release\_notes/][http_rocketmq.apache.org_release_notes]  
![image.png][image.png 1]  
下载并解压 rocketmq 安装包。

#### （2）配置系统环境变量 ####

配置系统变量 ROCKETMQ\_HOME=“D:\\soft\\rocketmq-all-4.5.1-bin-release”，如下图所示：  
注意：每个人 rocketmq 存放目录不一样，我的在 D:\\soft 下，用户根据自己的环境配置相应的系统变量。  
![image.png][image.png 2]

> 因为接下来启动 mqnamesrv.cmd 中使用到了环境变量 %ROCKETMQ\_HOME%，所以这里需要配置此系统变量。

#### （3）启动 namesrv ####

进入 rocketmq 的 bin 目录，执行 `start mqnamesrv.cmd` ，执行成功如下图所示：  
![image.png][image.png 3]  
注意：启动之后，不能关闭此窗口。

#### （4）启动 broker ####

还是在 bin 目录下执行 `start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true` ，执行成功如下图所示：  
![image.png][image.png 4]  
同样不要关闭以上运行窗口。  
完成以下步骤，说明你的 RocketMQ 已经按照成功了。

### 2 安装可视化插件 ###

#### （1）下载插件 ####

打开连接 [https://github.com/apache/rocketmq-externals.git][https_github.com_apache_rocketmq-externals.git] 下载可视化插件 rocketmq-externals，如下图所示：  
![image.png][image.png 5]  
点击 Download ZIP 进行下载。

> 我为大家准备了国内百度云的下载链接，方便大家使用。  
> 百度链接：[https://pan.baidu.com/s/1sMO6W-562IFJF1uUBQFXYg][https_pan.baidu.com_s_1sMO6W-562IFJF1uUBQFXYg]  
> 提取码：fuzy

#### （2）配置插件 ####

下载完成之后，进入 rocketmq-externals\\rocketmq-console\\src\\main\\resources\\application.properties 进行配置，如下图所示：  
![image.png][image.png 6]  
其中主要的字段说明如下：

*  server.port=8066：此可视化插件的运行端口。
 *  rocketmq.config.namesrvAddr=127.0.0.1:9876：rocketmq 的链接信息。

#### （3）编译插件 ####

进入 rocketmq-externals\\rocketmq-console 文件夹，执行 `mvn clean package -Dmaven.test.skip=true`  
编译项目。  
编译成功如下图所示：  
![image.png][image.png 7]  
编译阶段有可能出现以下两个问题，没有找到 mvn 命令，或编译超级慢的问题，以下提供解决方案。

##### 问题一：mvn 非可以运行的命令 #####

解决方案：这是因为没有安装 Maven 或者没有配置 Maven 的环境变量导致的，下载 Maven 安装包，增加环境变量 `MAVEN_HOME=maven安装目录` ，给 path 中添加 `%MAVEN_HOME%\bin` ，重新启动命令行工具（CMD）重新执行命令。

##### 问题二：编译超慢的问题 #####

解决方案：这是因为使用 Maven 数据源为国外源的问题导致的，只需要配置阿里的 Maven 源即可。  
打开 Maven 目录下的 conf/setting.xml 给 mirrors 节点下添加如下内容：

<mirror>
     <id>alimaven</id>
     <name>aliyun maven</name>
     <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
     <mirrorOf>central</mirrorOf>        
    </mirror>

#### （4）运行插件 ####

编译成功之后，进入 target 文件夹，执行 `java -jar rocketmq-console-ng-1.0.1.jar` 启动程序。  
启动成功之后，在浏览器输入地址 [http://127.0.0.1:8066][http_127.0.0.1_8066] 进行访问，效果如下图：  
![image.png][image.png 8]

### 3 基础使用 ###

#### （1）添加引用 jar 包 ####

pom.xml 添加以下代码：

<dependency>
        <groupId>com.alibaba.rocketmq</groupId>
        <artifactId>rocketmq-client</artifactId>
        <version>3.6.2.Final</version>
    </dependency>

#### （2）添加生产者和消费者代码 ####

public class RocketMQDemo {
        static final String MQ_NAMESRVADDR = "localhost:9876";
        public static void main(String[] args) {
            // 分组名
            String groupName = "myGroup-1";
            // 主题名
            String topicName = "myTopic-1";
            // 标签名
            String tagName = "myTag-1";
            new Thread(() -> {
                try {
                    producer(groupName, topicName, tagName);
                } catch (InterruptedException e) {
                    e.printStackTrace();
                } catch (RemotingException e) {
                    e.printStackTrace();
                } catch (MQClientException e) {
                    e.printStackTrace();
                } catch (MQBrokerException e) {
                    e.printStackTrace();
                }
            }).start();
            new Thread(() -> {
                try {
                    consumer(groupName, topicName, tagName);
                } catch (MQClientException e) {
                    e.printStackTrace();
                }
            }).start();
        }
    
        /**
         * @Description 生产者
         * @Author wanglei
         * @Param [groupName 分组名, topicName 主题名, tagName 标签名]
         **/
        public static void producer(String groupName, String topicName, String tagName) throws InterruptedException, RemotingException, MQClientException, MQBrokerException {
            DefaultMQProducer producer = new DefaultMQProducer(groupName);
            producer.setNamesrvAddr(MQ_NAMESRVADDR);
            producer.start();
            String body = "Hello, 老王";
            Message message = new Message(topicName, tagName, body.getBytes());
            producer.send(message);
            producer.shutdown();
        }
    
        /**
         * @Description 消费者
         * @Author wanglei
         * @Param [groupName 分组名, topicName 主题名, tagName 标签名]
         **/
        public static void consumer(String groupName, String topicName, String tagName) throws MQClientException {
            DefaultMQPushConsumer consumer = new DefaultMQPushConsumer(groupName);
            consumer.setNamesrvAddr(MQ_NAMESRVADDR);
            consumer.subscribe(topicName, tagName);
            consumer.registerMessageListener(new MessageListenerConcurrently() {
                @Override
                public ConsumeConcurrentlyStatus consumeMessage(
                        List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
                    for (MessageExt msg : msgs) {
                        System.out.println(new String(msg.getBody()));
                    }
                    return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
                }
            });
            consumer.start();
        }
    }

以上程序执行结果如下：

> Hello, 老王

![image.png][image.png 9]

[image.png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE1MTA2MTk2OC03NjMyNDdiMC04NGY1LTQ3NjMtYWNlMS0yY2M0M2E1OWQ3MmIucG5n#align=left&display=inline&height=441&name=image.png&originHeight=727&originWidth=1217&size=94004&status=done&width=737.5757149450294
[http_rocketmq.apache.org_release_notes]: http://rocketmq.apache.org/release_notes/
[image.png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjEzODEwODk2Ny0zMDNlMDQ3ZC04YTNjLTQ4YmMtODM5My04ZmY5NGVjMWFiMGYucG5n#align=left&display=inline&height=236&name=image.png&originHeight=390&originWidth=1349&size=53480&status=done&width=817.5757103211541
[image.png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjEzODU0NjEyNy0zZjQwZWMxMy0zN2VmLTQxOTctYmU3Zi0zZmI5OTIwMjAzMzYucG5n#align=left&display=inline&height=158&name=image.png&originHeight=261&originWidth=1026&size=20655&status=done&width=621.8181458780609
[image.png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjEzOTcyNzU5Ni1kMWU5NThmYy1kMTQwLTQwOGItYWI0NC04ZTUyMmNkY2EwZmUucG5n#align=left&display=inline&height=665&name=image.png&originHeight=1097&originWidth=1468&size=97028&status=done&width=889.6969182738727
[image.png 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE0NTAyMzkzOS1jZmNjYWY3Yi0wNmE3LTQ2MzQtYjUxZS1iZTU0ZmNmYzQzYTEucG5n#align=left&display=inline&height=134&name=image.png&originHeight=221&originWidth=1443&size=23484&status=done&width=874.5454039980915
[https_github.com_apache_rocketmq-externals.git]: https://github.com/apache/rocketmq-externals.git
[image.png 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE0MTA2MjM2Ni0zNDFjZTMzZC1lMzVlLTRkY2ItYWFjMS0yMWQ4NDQ2YTY3NzgucG5n#align=left&display=inline&height=297&name=image.png&originHeight=490&originWidth=745&size=55508&status=done&width=451.5151254182801
[https_pan.baidu.com_s_1sMO6W-562IFJF1uUBQFXYg]: https://pan.baidu.com/s/1sMO6W-562IFJF1uUBQFXYg
[image.png 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE0MTc4OTEzOS1hMmNiNTk2ZC02OGEwLTQ2NTItOTkzYi1mNjllYWE1ODQ5NmEucG5n#align=left&display=inline&height=539&name=image.png&originHeight=889&originWidth=1779&size=174356&status=done&width=1078.181755864591
[image.png 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE0NDExMTI0My1mMTAyNWI4Ni0yZDFiLTQwNGMtODZmYS0xMDBjNDdhOWRiMjEucG5n#align=left&display=inline&height=302&name=image.png&originHeight=499&originWidth=1462&size=81447&status=done&width=886.0605548476852
[http_127.0.0.1_8066]: http://127.0.0.1:8066
[image.png 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE0NjQyMjcwMi1jZjBhODA0MC1mNDkxLTQzNzktOGMzNC02NDQzZWUzN2NlZTIucG5n#align=left&display=inline&height=938&name=image.png&originHeight=1548&originWidth=2038&size=204315&status=done&width=1235.1514437616843
[image.png 9]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4ubmxhcmsuY29tL3l1cXVlLzAvMjAxOS9wbmcvOTI3OTEvMTU2MjE1MjY0NDc5NS1mNWM4MjU3ZC04N2NhLTQ5NTQtOGExZS02MzkwNmQ1MzU3OTUucG5n#align=left&display=inline&height=218&name=image.png&originHeight=359&originWidth=730&size=68802&status=done&width=442.42421685281136