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

本文详述RocketMQ的官方教程,涵盖添加依赖、同步/异步/单向消息发送及消费消息。提供了详细注释的示例代码,并强调不同发送模式在不同业务场景中的应用,如同步适合重要通知,异步适用于高时效性需求,单向则适用于日志收集。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

本翻译教程来自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();
    }
}

消费消息

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值