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

最新推荐文章于 2025-08-19 18:46:01 发布

James^23.の

最新推荐文章于 2025-08-19 18:46:01 发布

阅读量252

点赞数

CC 4.0 BY-SA版权

文章标签： java 程序员 RocketMQ

本文链接：https://blog.youkuaiyun.com/JWinni/article/details/95663750

本文介绍了如何在Windows环境下搭建Apache RocketMQ的可视化环境，包括下载安装RocketMQ，配置系统环境变量，启动NameServer和Broker，以及安装和配置可视化插件。同时，文章还讲解了RocketMQ的基础使用，如添加依赖，创建生产者和消费者代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

RocketMQ 是一款分布式消息中间件，最初是由阿里巴巴消息中间件团队研发并大规模应用于生产系统，满足线上海量消息堆积的需求，在 2016 年底捐赠给 Apache 开源基金会成为孵化项目，经过不到一年时间正式成为了 Apache 顶级项目。

早期阿里曾经基于 ActiveMQ 研发消息系统，随着业务消息的规模增大，瓶颈逐渐显现，后来也考虑过Kafka，但因为在低延迟和高可靠性方面没有选择，最后才自主研发了 RocketMQ， 各方面的性能都比目前已有的消息队列要好，RocketMQ 和 Kafka 在概念和原理上都非常相似，所以也经常被拿来对比；RocketMQ 默认采用长轮询的拉模式，单机支持千万级别的消息堆积，可以非常好的应用在海量消息系统中。

本文分为三部分，如下图所示：
在这里插入图片描述

1 安装 RocketMQ 版本

（1）下载 Windows 安装包
Windows 版本下载地址：http://rocketmq.apache.org/release_notes/
在这里插入图片描述
下载并解压 rocketmq 安装包。

（2）配置系统环境变量
配置系统变量 ROCKETMQ_HOME=“D:\soft\rocketmq-all-4.5.1-bin-release”，如下图所示：
注意：每个人 rocketmq 存放目录不一样，我的在 D:\soft 下，用户根据自己的环境配置相应的系统变量。
在这里插入图片描述

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

（3）启动 namesrv
进入 rocketmq 的 bin 目录，执行 start mqnamesrv.cmd ，执行成功如下图所示：
在这里插入图片描述
注意：启动之后，不能关闭此窗口。

（4）启动 broker
还是在 bin 目录下执行 start mqbroker.cmd-n127.0.0.1:9876autoCreateTopicEnable=true ，执行成功如下图所示：
在这里插入图片描述
同样不要关闭以上运行窗口。
完成以下步骤，说明你的 RocketMQ 已经按照成功了。

2 安装可视化插件

（1）下载插件
打开连接 https://github.com/apache/rocketmq-externals.git 下载可视化插件 rocketmq-externals，如下图所示：
在这里插入图片描述
点击 Download ZIP 进行下载。

（2）配置插件
下载完成之后，进入 rocketmq-externals\rocketmq-console\src\main\resources\application.properties 进行配置，如下图所示：
在这里插入图片描述
其中主要的字段说明如下：

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

（3）编译插件
进入 rocketmq-externals\rocketmq-console 文件夹，执行 mvn cleanpackage-Dmaven.test.skip=true
编译项目。
编译成功如下图所示：
在这里插入图片描述
编译阶段有可能出现以下两个问题，没有找到 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 进行访问，效果如下图：
在这里插入图片描述

3 基础使用

（1）添加引用 jar 包
pom.xml 添加以下代码：

<!-- https://mvnrepository.com/artifact/com.alibaba.rocketmq/rocketmq-client -->
<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();
    }
}

以上程序执行结果如下：