本翻译教程来自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();
}
}
消费消息
消费消息的代码与快速开始中的一样。