一文带你搭建 RocketMQ 源码调试环境
大家好，我是悟空呀。
前言
最近在倒腾 RocketMQ 消息队列，小卷了下 RocketMQ 的源码，本篇会带着看下如何配置好调试源码的环境。
一、获取源码
首先就是到 Github 网站上下载源码。
源码地址：https://github.com/apache/rocketmq/releases
我下载的是这个版本：rocketmq-rocketmq-all-4.9.2。
如果遇到 Github 网站的打开速度较慢，可以在公众号后台回复 RocketMQ源码 即可获取百度网盘链接。
二、导入源码
下载好了后，用 IntelliJ IDEA 工具导入就可以了。
下面是对各个文件夹相关功能的解释：
broker：RocketMQ 的 Broker 相关的代码，用来启动 Broker 进程。重点要看的。
client：RocketMQ 的 Producer、Consumer 这些客户端的代码，用来生产消息、消费消息。
common：公共模块。
dev：开发相关的一些信息
distribution：用来部署 RocketMQ 的，比如 bin 目录 ，conf 目录。
example：使用 RocketMQ 的例子。
filter：RocketMQ 的一些过滤器。
logappender：RocketMQ 日志相关的
logging：RocketMQ 日志相关的
namesvr：NameServer 的源码。重点要看的。
openmessaging：开放消息标准，可以先忽略
remoting：RocketMQ 的远程网络通信模块的代码，基于 netty 实现。重点要看的。
srvutil：里面有很多工具类。
store：消息如何在 Broker 上进行存储的。重点要看的。
style： 代码检查相关的。
test：测试相关的。
tools：命令行监控工具相关。
我们看源码是不是直接就各种文件都看一遍呢？当然不是，首先得把项目跑起来吧，接下来看下如何让 RocketMQ 的 NameServer 和 Broker 启动起来。NameServer 就是所有 Broker 都需要注册的地方，注册中心。Broker 就是用来收客户端发的消息、存储消息传、递消息给消费端的组件。
三、启动 RocketMQ 的 NameServer
3.1 配置 NameServer 启动参数
因为在本地直接启动源码是起不来的，需要单独配置下启动参数。
3.1.1 Edit Configurations
首先在 IDEA 工具的菜单栏中找到 NameSrvStartup 启动的地方，然后下拉选择 Edit Configurations，可以打开 NameSrvStartup 的配置项。如下图所示：
3.1.2 环境变量
需要配置一个 ROCKETMQ_HOME 环境变量，它就是一个本地文件夹，专门用来存放一些配置文件，这个文件夹的名字后面还会用到。
打开配置环境变量的界面，如下图所示，点下这个按钮就可以了：
然后我们点下加号，配置 ROCKETMQ_HOME 环境变量，文件夹路径我是配置在这里的，大家可以自己配置，注意不要和 RocketMQ 源码目录里面。
3.1.3 拷贝配置文件
首先在 ROCKMQ_HOME 目录新建几个文件夹：conf、logs、store
然后我们需要 RoctetMQ 自带的配置文件拷贝到 conf 目录下。
配置文件就是需要从源码目录中 distribution 目录下 拷贝三个文件：broker.conf、logback_namesrv.xml、logback_broker.xml。
3.1.4 修改 logback 日志配置文件
然后打开 logback_namesrv.xml 和 logback_broker.xml 文件，将 ${user.home} 全局替换为之前配置的 ROCKETMQ_HOME 目录。
替换后的配置如下图所示：
3.1.5 修改 broker 配置文件
打开 conf 目录下的 broker.xml 文件，拷贝下面的配置的到文件中。
注意：brokerIP1 对应的 IP 地址是自己本机 IP。存储路径对应 ROCKETMQ_HOME 的 store 目录。
3.1.6 启动 NameServer
上面的配置都配置好了，就可以用 IDEA 启动了，注意，直接可以用 debug 模式启动。
IDEA 会自动找到 ROCKETMQ_HOME 的环境变量，这个目录就是 RocketMQ 的运行目录，里面有新建的 conf、logs、store 目录。conf 对应配置，logs 对应日志、store 对应数据存储。
然后我们可以在控制台看到启动的日志输出：
四、启动 RocketMQ 的 Broker
3.1 配置 Broker 的启动参数
和 NameServer 的启动参数相似需要配置环境变量，但是 Broker 多了一个 Program arguments 配置项，用来加载指定的配置文件 broker.conf。配置如下：
4.2 启动 Broker
接着用 debug 模式启动 broker，可以看到控制台输出以下信息：
4.3 查看启动日志
另外我们到 logs 目录看下启动的详细日志，打开 broker.log 或者 namesrv.log 文件，如下所示：
五、测试发送消息
我们直接用源码自带的示例代码来做测试。文件目录如下：
打开 Producer.java 文件
修改如下代码中的 IP 地址
然后在 IDEA 中启动这个类：
可以看到控制台打印了输出结果，成功发送了一条消息。注意：消费者的示例代码里面，我改成了只发送了一条消息。
接着我们启动消费者代码，看下是否成功消费了。同样需要修改这个配置：
然后启动 Consumer，可以看到成功消费了一条消息：
注意：消息的显示是用 ASCII 码来表示的，所以不能直接看出来发送的什么。
好了，本地的源码调试环境配置完成。
RocketMQ 也是有客户端界面来查看 RocketMQ 的运行情况的。如下所示：
下一篇给大家安排上， RocketMQ 的控制台的安装和详细使用说明。
我是悟空，期待和你一起打怪升级变强！
版权声明: 本文为 InfoQ 作者【悟空聊架构】的原创文章。
原文链接:【http://xie.infoq.cn/article/28a4e9207bdc6bd2b7681b159】。未经作者许可，禁止转载。
用故事、大白话讲解Java、分布式、架构设计 2018.05.06 加入
公众号：「悟空聊架构」 【个人博客】www.passjava.cn 【开源项目】基于 SpringCloud 的一套面试刷题系统 【Github】https://github.com/Jackson0714/PassJava-Platform
评论