RocketMQ使用步骤--- 开发测试环境搭建及Java用例

       RocketMQ使用JAVA语言编写，可以在任意安装了JRE环境的平台上运行。但，必须要运行在安装JRE64位的操作系统上,RocketMQ官方暂时不提供API文档，接口使用可参考源码中的实例代码，或根据本文中API步骤，完成你的RocketMQ 学习之旅吧，祝你旅途愉快!                                             

一、Git 安装（注：如果系统没有git 先安装git）

安装命令 yum  install git 

二、Maven 安装 （注：安装二进制maven，版本选择maven 3.0.4）

作者曾试过使用maven2.2.1版本，当安装RocketMQ时，会出现了问题。可能是RocketMQ 不支持maven2.*版本。

Maven版本库列表：http://archive.apache.org/dist/maven/binaries/ 

下载命令 wget  -c  "http://archive.apache.org/dist/maven/binaries/apache-maven-3.0.4-bin.zip"

下载好的maven默认路径在/root 目录下,解压命令 unzip apache-maven-3.0.4-bin.zip

将 解压后文件 apache-maven-3.0.4 拷贝到 自己的软件目录下,命令进入 自己的软件目录下  cd  /opt/soft 

将刚刚下载解压好的 /root/apache-maven-3.0.4 拷贝到/opt/soft目录下

cp -a  /root/apache-maven-3.0.4  .

为mavne 配置环境变量 , 在/ect/profile 文件中配置 .

MAVEN_HOME=/opt/soft/apache-maven-3.0.4
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin

这时maven 就安装和配置完成了。接下来要用git 命令，下载阿里的RocketMQ中间件。

三、下载及安装RocketMQ

下载 ：git clone https://github.com/alibaba/RocketMQ.git

下载好的RocketMQ默认路径在/opt/soft/ 目录下 ，先进入RocketMQ 目录 ，  命令 cd RocketMQ

找到install.sh 安装文件，执行安装命令  sh install.sh

安装完成后，因为install.sh脚本中创建devenv 符号链接写错了目录，需要在RocketMQ目录下执行如下命令：   

rm -rf devenv  
ln -s target/alibaba-rocketmq-3.2.6-alibaba-rocketmq/alibaba-rocketmq/ devenv

备注：如对linux 命令不熟悉的先了解一下，ln -s 命令 。上面命令是将target/alibaba-rocketmq-3.2.6-alibaba-rocketmq/alibaba-rocketmq/ 目录，创建一个类似快捷键的目录

devenv 目录，切记target 文件必须在RocketMQ安装完才会出现，在RocketMQ 安装之前没有这个目录。

四、启动RocketMQ

cd devenv/bin
nohup sh mqnamesrv &
nohup sh mqbroker -n 10.0.0.245:9876 autoCreateTopicEnable=true &
more nohup.out

1、以上命令单号执行

2、后面必须拼接 &

  如果显示：

       The Name Server boot success.        The broker[vdata.kt, 192.168.230.128:10911] boot success.

       则NameServer,Broker启动成功

到目前为止，所有的RocketMQ 的搭建部署等工作已经全部完成，接下来用java写个RocketMQ的生产者Producter和消费者Consumer用例。

五、在eclipse中开发测试

       1.创建一个maven项目，其pom.xml的内容见pom.xml

       2. 编写消息产生者Producer,见Producer.java

       3.编写消息消费者Consumer,见PushConsumer.java

package com.catt.rocketmq.example;

import java.util.concurrent.TimeUnit;

import com.alibaba.rocketmq.client.exception.MQClientException;
import com.alibaba.rocketmq.client.producer.DefaultMQProducer;
import com.alibaba.rocketmq.client.producer.SendResult;
import com.alibaba.rocketmq.common.message.Message;

public class Producer {
  public static void main(String[] args) throws MQClientException,
      InterruptedException {
    /**
     * 一个应用创建一个Producer，由应用来维护此对象，可以设置为全局对象或者单例

     * 注意：ProducerGroupName需要由应用来保证唯一

     * ProducerGroup这个概念发送普通的消息时，作用不大，但是发送分布式事务消息时，比较关键，
     * 因为服务器会回查这个Group下的任意一个Producer
     */
    DefaultMQProducer producer = new DefaultMQProducer("ProducerGroupName");
    producer.setNamesrvAddr("192.168.230.128:9876");
    producer.setInstanceName("Producer");

    /**
     * Producer对象在使用之前必须要调用start初始化，初始化一次即可

     * 注意：切记不可以在每次发送消息时，都调用start方法
     */
    producer.start();

    /**
     * 下面这段代码表明一个Producer对象可以发送多个topic，多个tag的消息。
     * 注意：send方法是同步调用，只要不抛异常就标识成功。但是发送成功也可会有多种状态，

     * 例如消息写入Master成功，但是Slave不成功，这种情况消息属于成功，但是对于个别应用如果对消息可靠性要求极高，

     * 需要对这种情况做处理。另外，消息可能会存在发送失败的情况，失败重试由应用来处理。
     */
    for (int i = 0; i < 100; i++) {
      try {
        {
          Message msg = new Message("TopicTest1",// topic
              "TagA",// tag
              "OrderID001",// key
              ("Hello MetaQ").getBytes());// body
          SendResult sendResult = producer.send(msg);
          System.out.println(sendResult);
        }

        {
          Message msg = new Message("TopicTest2",// topic
              "TagB",// tag
              "OrderID0034",// key
              ("Hello MetaQ").getBytes());// body
          SendResult sendResult = producer.send(msg);
          System.out.println(sendResult);
        }

        {
          Message msg = new Message("TopicTest3",// topic
              "TagC",// tag
              "OrderID061",// key
              ("Hello MetaQ").getBytes());// body
          SendResult sendResult = producer.send(msg);
          System.out.println(sendResult);
        }
      } catch (Exception e) {
        e.printStackTrace();
      }
      TimeUnit.MILLISECONDS.sleep(1000);
    }

    /**
     * 应用退出时，要调用shutdown来清理资源，关闭网络连接，从MetaQ服务器上注销自己
     * 注意：我们建议应用在JBOSS、Tomcat等容器的退出钩子里调用shutdown方法
     */
    producer.shutdown();
  }
}

PushConsumer.java

package com.catt.rocketmq.example;

import java.util.List;

import com.alibaba.rocketmq.client.consumer.DefaultMQPushConsumer;
import com.alibaba.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
import com.alibaba.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
import com.alibaba.rocketmq.client.consumer.listener.MessageListenerConcurrently;
import com.alibaba.rocketmq.client.exception.MQClientException;
import com.alibaba.rocketmq.common.message.MessageExt;

public class PushConsumer {

  /**
   * 当前例子是PushConsumer用法，使用方式给用户感觉是消息从RocketMQ服务器推到了应用客户端。

   * 但是实际PushConsumer内部是使用长轮询Pull方式从MetaQ服务器拉消息，然后再回调用户Listener方法

   */
  public static void main(String[] args) throws InterruptedException,
      MQClientException {
    /**
     * 一个应用创建一个Consumer，由应用来维护此对象，可以设置为全局对象或者单例

     * 注意：ConsumerGroupName需要由应用来保证唯一
     */
    DefaultMQPushConsumer consumer = new DefaultMQPushConsumer(
        "ConsumerGroupName");
    consumer.setNamesrvAddr("192.168.230.128:9876");
    consumer.setInstanceName("Consumber");

    /**
     * 订阅指定topic下tags分别等于TagA或TagC或TagD
     */
    consumer.subscribe("TopicTest1", "TagA || TagC || TagD");
    /**
     * 订阅指定topic下所有消息

     * 注意：一个consumer对象可以订阅多个topic
     */
    consumer.subscribe("TopicTest2", "*");

    consumer.registerMessageListener(new MessageListenerConcurrently() {

      /**
       * 默认msgs里只有一条消息，可以通过设置consumeMessageBatchMaxSize参数来批量接收消息
       */
      @Override
      public ConsumeConcurrentlyStatus consumeMessage(
          List msgs, ConsumeConcurrentlyContext context) {
        System.out.println(Thread.currentThread().getName()
            + " Receive New Messages: " + msgs.size());

        MessageExt msg = msgs.get(0);
        if (msg.getTopic().equals("TopicTest1")) {
          // 执行TopicTest1的消费逻辑
          if (msg.getTags() != null && msg.getTags().equals("TagA")) {
            // 执行TagA的消费
            System.out.println(new String(msg.getBody()));
          } else if (msg.getTags() != null
              && msg.getTags().equals("TagC")) {
            // 执行TagC的消费
          } else if (msg.getTags() != null
              && msg.getTags().equals("TagD")) {
            // 执行TagD的消费
          }
        } else if (msg.getTopic().equals("TopicTest2")) {
          System.out.println(new String(msg.getBody()));
        }

        return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
      }
    });

    /**
     * Consumer对象在使用之前必须要调用start初始化，初始化一次即可

     */
    consumer.start();

    System.out.println("Consumer Started.");
  }
}

注意：docker 虚拟环境下，部署RocketMQ 会报错为：connect to <容器IP:10911> failed。因为docker 返回的IP不是与你请求的IP 不同，所以无法建立连接。临时解决办法：将NamesrvAddr 的IP地址换成docker 的IP ,并且将项目部署到docker虚拟环境内。正式环境建议不要使用docker虚拟机。

启动rocketMq命令： 

sh mqnamesrv &

sh mqbroker -c ../conf/2m-noslave/broker-a.properties &

1. 登录控制台： 首先进入 RocketMQ 工程，进入/RocketMQ/bin   在该目录下有个 mqadmin 脚本 .

 查看帮助：   在 mqadmin 下可以查看有哪些命令  

 a:  查看具体命令的使用 :  sh mqadmin    

 b: sh mqadmin help 命令名称  

例如，查看 updateTopic 的使用

sh mqadmin help updateTopic

2. 关闭nameserver和所有的broker:

   进入到bin下： 

   sh mqshutdown namesrv

   sh mqshutdown broker

3. 查看所有消费组group:

   sh mqadmin consumerProgress -n 192.168.23.159:9876

4. 查看指定消费组下的所有topic数据堆积情况：

    sh mqadmin consumerProgress -n 192.168.23.159:9876 -g ywdGroupConsumer

5. 查看所有topic :

      sh mqadmin topicList -n 192.168.23.159:9876

6. 查看topic信息列表详情统计

   sh mqadmin topicstatus -n 192.168.23.159:9876 -t myTopicTest1

7.  新增topic

   sh mqadmin updateTopic –n 10.45.47.168 –c DefaultCluster –t ZTEExample

8. 删除topic

  sh mqadmin deleteTopic –n 10.45.47.168:9876 –c DefaultCluster –t ZTEExample

如果您喜欢我写的博文，读后觉得收获很大，不妨小额赞助我一下，让我有动力继续写出高质量的博文，感谢您的赞赏！！！