RocketMQ官方教程（翻译加扩充）——简单的消息示例

本翻译教程来自RocketMQ官方网站，中间会加上自己的理解，有错误或者不妥之处请及时指正。

我在官方示例代码中加了详细的注释，如果读者想要方便的下载这些代码，包括后面所有博客中有关RocketMQ教程中用到的代码，请到我的GitHub仓库进行下载。

• 使用RocketMQ以三种方式来发送消息：可靠同步、可靠异步和单向模式
• 使用RocketMQ来消费消息

添加依赖

maven:

    <dependency>
        <groupId>org.apache.rocketmq</groupId>
        <artifactId>rocketmq-client</artifactId>
        <version>4.3.0</version>
    </dependency>

gradle:

compile 'org.apache.rocketmq:rocketmq-client:4.3.0'

同步地发送消息

可靠同步消息传输在大量场景下被使用，例如重要的通知消息，短信通知，短信营销系统等

同步发送消息是指，在一个消息发送之后，必须要等待接收方回应之后才会发送下一个消息。代码如下，其实跟上一篇文章快速开始中的生产者一样。

package org.apache.rocketmq.example.simplemessage;

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;

public class SyncProducer {
    public static void main(String[] args) throws Exception {
        // 实例化DefaultMQProducer，这里如要设置生产者组名。
        DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
        // 指明name server的地址
        producer.setNamesrvAddr("localhost:9876");
        // 启动producer实例，只需要启动一次
        producer.start();
        //循环发送消息
        for (int i = 0; i < 100; i++) {
            //创建消息实例，指定topic、tag和消息主体
            Message msg = new Message("TopicTest" /* Message 所属的 Topic */,
                    "TagA" /* Message Tag 可理解为 Gmail 中的标签，对消息进行再归类，方便 Consumer 指定过滤条件在消息队列 RocketMQ 的服务器过滤 */,
                    ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET)
                    /*  Message Body 可以是任何二进制形式的数据， 消息队列 RocketMQ 不做任何干预，
                    需要 Producer 与 Consumer 协商好一致的序列化和反序列化方式 */
            );
            //调用send方法来将消息发送给其中一个broker
            SendResult sendResult = producer.send(msg);
            //同步发送消息，发送一个消息之后立马就能够收到响应
            System.out.printf("%s%n", sendResult);
        }
        //最后关闭生产者producer，只需关闭一次
        producer.shutdown();
    }
}

异步消息发送

异步传输通常用于响应时间敏感的业务场景。

异步发送是指发送方发出数据后，不等接收方发回响应，接着发送下个数据包的通讯方式。 消息队列 RocketMQ 的异步发送，需要用户实现异步发送回调接口（SendCallback）。消息发送方在发送了一条消息后，不需要等待服务器响应即可返回，进行第二条消息发送。发送方通过回调接口接收服务器响应，并对响应结果进行处理。

异步发送一般用于链路耗时较长，对 RT 响应时间较为敏感的业务场景，例如用户视频上传后通知启动转码服务，转码完成后通知推送转码结果等。

package org.apache.rocketmq.example.simplemessage;

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

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;

public class AsyncProducer {
    public static void main(String[] args) throws Exception {
        //实例化DefaultMQProducer，这里如要设置生产者组名。
        DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
        //指明name server的地址
        producer.setNamesrvAddr("localhost:9876");
        //启动producer实例，只需要启动一次
        producer.start();
        //当异步发送失败，内部执行的最大重发次数，内部执行重发可能导致消息重复，这里设置为0
        producer.setRetryTimesWhenSendAsyncFailed(0);
        int messageCount = 100;
        final CountDownLatch countDownLatch = new CountDownLatch(messageCount);
        for (int i = 0; i < messageCount; i++) {
            try {
                final int index = i;
                //创建消息实例，指定topic、tag和消息主体
                Message msg = new Message("Jodie_topic_1023",
                        "TagA",
                        "OrderID188",
                        "Hello world".getBytes(RemotingHelper.DEFAULT_CHARSET));
                // 异步发送消息, 该方法立即返回。当发送完成之后sendCallback将会被执行
                producer.send(msg, new SendCallback() {
                    public void onSuccess(SendResult sendResult) {
                        // 消费发送成功
                        countDownLatch.countDown();
                        System.out.printf("%-10d OK %s %n", index, sendResult.getMsgId());
                    }
                    public void onException(Throwable e) {
                        // 消息发送失败
                        countDownLatch.countDown();
                        System.out.printf("%-10d Exception %s %n", index, e);
                        e.printStackTrace();
                    }
                });
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        //等待异步回调被执行，或者5秒之内还没有被执行完成，结束等待
        countDownLatch.await(5, TimeUnit.SECONDS);
        //最后关闭生产者producer，只需关闭一次
        producer.shutdown();
    }
}

以单向模式发送消息

单向传输用于需要中等可靠性的情况，例如日志收集。

单向（Oneway）发送特点为发送方只负责发送消息，不等待服务器回应且没有回调函数触发，即只发送请求不等待应答。 此方式发送消息的过程耗时非常短，一般在微秒级别。适用于某些耗时非常短，但对可靠性要求并不高的场景，例如日志收集。

package org.apache.rocketmq.example.simplemessage;

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

public class OnewayProducer {
    public static void main(String[] args) throws Exception {
        // 实例化DefaultMQProducer，这里如要设置生产者组名。
        DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
        // 指明name server的地址
        producer.setNamesrvAddr("localhost:9876");
        // 启动producer实例，只需要启动一次
        producer.start();
        //循环发送消息
        for (int i = 0; i < 100; i++) {
            //创建消息实例，指定topic、tag和消息主体
            Message msg = new Message("TopicTest" /* Message 所属的 Topic */,
                    "TagA" /* Message Tag 可理解为 Gmail 中的标签，对消息进行再归类，方便 Consumer 指定过滤条件在消息队列 RocketMQ 的服务器过滤 */,
                    ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET)
                    /*  Message Body 可以是任何二进制形式的数据， 消息队列 RocketMQ 不做任何干预，
                    需要 Producer 与 Consumer 协商好一致的序列化和反序列化方式 */
            );
            // 单向模式直接发送消息而不等待broker的确认信息，这种方式具有最大的吞吐量，但是却有丢失信息的风险
            producer.sendOneway(msg);
        }
        //最后关闭生产者producer，只需关闭一次
        producer.shutdown();
    }
}

消费消息

消费消息的代码与快速开始中的一样。