RocketMQ 分布式消息中间件-Java端入门代码示例

发表于 分类于 ， 评论数： 阅读次数：
本文字数： 9.2k 阅读时长 ≈ 8 分钟

开发准备

依赖

新建Maven工程，引入依赖

1
2
3
4
5
6
<!-- https://mvnrepository.com/artifact/org.apache.rocketmq/rocketmq-client -->
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client</artifactId>
    <version>4.5.0</version>
</dependency>
  • 这里我还引入了一个rocketmq-example，这里面的示例代码和官方文档是一直的，可以直接参考
1
2
3
4
5
6
<!-- https://mvnrepository.com/artifact/org.apache.rocketmq/rocketmq-example -->
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-example</artifactId>
    <version>4.5.0</version>
</dependency>
  • 前一步的RocketMQ服务搭建并运行无误就可以进入Java编码了

命令

  • 这里重点说一下，防火墙请放行9876端口，如果可以请把防火墙彻底关掉。
  • 贴上CentOS7中 firewalld 的基本使用命令：
    • 启动：systemctl start firewalld
    • 关闭：systemctl stop firewalld
    • 查看状态：systemctl status firewalld
    • 开机禁用 ：systemctl disable firewalld
    • 开机启用 ：systemctl enable firewalld
    • 放行9876端口：firewall-cmd --zone=public --add-port=9876/tcp --permanent（–permanent永久生效，没有此参数重启后失效）
    • 重新载入：firewall-cmd --reload（修改端口后需要重新载入）
    • 查看9876端口：firewall-cmd --zone= public --query-port=9876/tcp
    • 删除9876端口：firewall-cmd --zone= public --remove-port=9876/tcp --permanent

文档

  • 本篇代码参照自官方文档及 rocketmq-example 中的示例代码
  • 官方文档及快速上手示例地址：https://rocketmq.apache.org/docs/simple-example/
  • Producer示例代码路径：org.apache.rocketmq.example.quickstart.Producer (需导入 rocketmq-example 依赖)
  • Customer示例代码路径：org.apache.rocketmq.example.quickstart.Customer (需导入 rocketmq-example 依赖)

编码运行

生产者

  • 代码参考，每个步骤写有注释
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
package com.rocketmq.demo;

import org.apache.rocketmq.client.exception.MQClientException;
import org.apache.rocketmq.client.producer.DefaultMQProducer;
import org.apache.rocketmq.client.producer.SendResult;
import org.apache.rocketmq.common.message.Message;
import org.apache.rocketmq.remoting.common.RemotingHelper;

/**
 * 生产者测试
 *
 * @author zhangkuan
 * @date 2019/4/8
 */
public class ProducerTest {

    public static void main(String[] args) throws MQClientException, InterruptedException {

        /**
         * 声明并初始化一个 Producer，同时指定 Producer Group 的名称
         * 一个应用创建一个 Producer，由应用来维护此对象，可以设置为全局对象或者单例
         * ProducerGroup 的名称 "producerGroupName" 需要由应用来保证唯一性
         * ProducerGroup 这个概念发送普通的消息时，作用不大，但是发送分布式事务消息时，比较关键，
         * 因为服务器会回查这个 Group 下的任意一个 Producer
         */
        DefaultMQProducer producer = new DefaultMQProducer("myProducerGroupName_1");
        /**
         * 指定 Producer 连接的 nameServer 服务器所在地址以及端口
         * 如果是分布式部署的多个，则用分号隔开，如：
         * setNamesrvAddr("172.16.235.77:9876;172.16.235.78:9876");
         * 这里只是为了方便才将地址与端口写死，实际中应该至少放在配置文件中去
         */
        producer.setNamesrvAddr("47.75.222.71:9876");
        /**
         * 指定自己的在 Producer Group 中的名称
         */
        producer.setInstanceName("myProducer_1");
        /**
         * Producer 对象在使用之前必须要调用 start 进行启动初始化
         * 初始化一次即可，切忌不可每次发送消息时，都调用start方法
         */
        producer.start();

        /**
         * 一个 Producer 对象可以发送多个 topic（主题），多个 tag 的消息
         * 本实例 send 方法采用同步调用，只要不抛异常就标识成功
         */
        boolean flag1 = true;
        boolean flag2 = true;
        for (int i = 0; i < 8; i++) {
            try {
                Message msg;
                if (i % 2 == 1) {
                    /*
                     * 创建一个消息实例，指定topic、tag和消息主体。
                     */
                    msg = new Message("myTopicTest_1", flag1 ? "TagA" : "TagB", ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET));
                    flag1 = !flag1;
                } else {
                    /*
                     * 创建一个消息实例，指定topic、tag和消息主体。
                     */
                    msg = new Message("myTopicTest_2", flag2 ? "TagC" : "TagD", ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET));
                    flag2 = !flag2;
                }
                /*
                 * 调用send message将消息传递给其中的一个节点
                 */
                SendResult sendResult = producer.send(msg);
                System.out.printf("%s%n", sendResult);
            } catch (Exception e) {
                e.printStackTrace();
                Thread.sleep(500);
            }
        }

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

消费者

  • 消费者代码，同样在注释中说明
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
package com.rocketmq.demo;

import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
import org.apache.rocketmq.client.exception.MQClientException;
import org.apache.rocketmq.common.consumer.ConsumeFromWhere;
import org.apache.rocketmq.common.message.MessageExt;

import java.util.List;

/**
 * 消费者测试
 *
 * @author zhangkuan
 * @date 2019/4/8
 */
public class CustomerTest {

    /**
     * 当前例子是 PushConsumer 用法，给用户感觉是消息从 RocketMQ 服务器推到了应用客户端。
     * 而实际 PushConsumer 内部是使用长轮询 Pull(拉取) 方式从 MetaQ 服务器拉消息，然后再回调用户 Listener方法
     *
     * @param args
     * @throws InterruptedException
     * @throws MQClientException
     */
    public static void main(String[] args) throws MQClientException {
        /**
         * 声明并初始化 一个 consumer
         * Consumer Group 组名，多个 Consumer 如果属于一个应用，订阅同样的消息，且消费逻辑一致，则应该将它们归为同一组
         * 一个应用创建一个 Consumer，由应用来维护此对象，可以设置为全局对象或者单例
         * ConsumerGroupName 需要由应用来保证唯一
         */
        DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("myCustomerGroupName_1");
        /**
         * 指定 NameServer 的地址 与端口
         * 指定自己在 Consumer Group 组中的名称
         */
        consumer.setNamesrvAddr("47.75.222.71:9876");
        consumer.setInstanceName("myConsumer_1");
        /**
         * 设置 consumer 的消费策略
         * CONSUME_FROM_LAST_OFFSET 默认策略，从该队列最尾开始消费，即跳过历史消息
         * CONSUME_FROM_FIRST_OFFSET 从队列最开始开始消费，即历史消息（还储存在broker的）全部消费一遍
         * CONSUME_FROM_TIMESTAMP 从某个时间点开始消费，和 setConsumeTimestamp() 配合使用，默认是半个小时以前
         */
        consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_FIRST_OFFSET);
        /**
         * 消费者订阅消息，如下所示订阅 topic 为 myTopicTest_1 下tag为 TagA 类型的消息
         * 订阅指定 topic 下 tags 分别等于TagC或TagD，则为：<code>consumer.subscribe("myTopicTest_2", "TagC||TagD");</code>
         * 一个 consumer 对象可以订阅多个 topic，如下
         */
        consumer.subscribe("myTopicTest_1", "TagA");
        consumer.subscribe("myTopicTest_2", "TagC||TagD");

        /**
         * 注册消息监听器，如果有订阅的消息就会响应
         */
        consumer.registerMessageListener(new MessageListenerConcurrently() {
            /**
             * 默认 msgs 里只有一条消息，可以通过设置 consumeMessageBatchMaxSize 参数来批量接收消息
             * consumeThreadMin:消费线程池数量 默认最小值10
             * consumeThreadMax:消费线程池数量 默认最大值20
             */
            @Override
            public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
                System.out.println(Thread.currentThread().getName() + " Receive New Messages: " + msgs.size());
                MessageExt msg = msgs.get(0);
                System.out.printf("%s Receive New Messages: %s %n", new Object[]{Thread.currentThread().getName(), msgs});
                System.out.println("----topic: " + msg.getTopic() + ", tag: " + msg.getTags() + ", body: " + new String(msg.getBody()));
                /**
                 * 返回消费状态
                 * CONSUME_SUCCESS 消费成功
                 * RECONSUME_LATER 消费失败，需要稍后重新消费
                 */
                //return ConsumeConcurrentlyStatus.RECONSUME_LATER;
                return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
            }
        });

        /**
         * Consumer对象在使用之前必须要调用start初始化，初始化一次即可
         */
        consumer.start();
        System.out.printf("Consumer Started.%n");
    }
}
# 采坑记录

RocketMQ服务外网不能访问

  • 如果你按照上一篇的方式运行，那么你可能会遇到下面这种错误（在本地运行RocketMQ不会遇到这个问题）
1
2
3
4
5
6
7
org.apache.rocketmq.remoting.exception.RemotingTooMuchRequestException: sendDefaultImpl call timeout
at org.apache.rocketmq.client.impl.producer.DefaultMQProducerImpl.sendDefaultImpl(DefaultMQProducerImpl.java:634)
at org.apache.rocketmq.client.impl.producer.DefaultMQProducerImpl.send(DefaultMQProducerImpl.java:1279)
at org.apache.rocketmq.client.impl.producer.DefaultMQProducerImpl.send(DefaultMQProducerImpl.java:1225)
at org.apache.rocketmq.client.producer.DefaultMQProducer.send(DefaultMQProducer.java:283)
at com.rocketmq.demo.ProducerTest.main(ProducerTest.java:69)
09:19:42.792 [NettyClientSelector_1] INFO  RocketmqRemoting - closeChannel: close the connection to remote address[] result: true

  • 那么你需要修改一些配置，在编译后的目录中的 conf 文件夹下有一个 broker.conf 配置文件，在其末尾添加如下配置：

    • vim /root/rocketmq-4.5.0/conf/broker.conf
1
2
3
4
5
6
7
8
9
10
11
12
brokerClusterName = DefaultCluster
brokerName = broker-a
brokerId = 0
deleteWhen = 04
fileReservedTime = 48
brokerRole = ASYNC_MASTER
flushDiskType = ASYNC_FLUSH

# 添加如下两行内容，'47.**.***.71'为你的服务器公网IP
namesrvAddr=47.**.***.71:9876
# 需要指定broker外网IP否则外网不能访问
brokerIP1=47.**.***.71
  • 然后将broker的运行方式改为： nohup sh bin/mqbroker -c conf/broker.conf &
明人不说暗话，如果你觉得可以的话，你懂的！