系列五(实战)、发送 & 接收同步消息(Java操作RocketMQ)

本文介绍了在Java中使用RocketMQ实现发送和接收同步消息的过程,包括创建生产者和消费者、配置NameServer、消息模型特点以及示例代码演示。

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

一、发送 & 接收同步消息

1.1、前置说明

        Java操作RocketMQ系列文章是基于Maven项目进行演示的,所以大家只需要新建一个普通的Maven项目,然后将pom、常量信息粘进自己的代码中即可!后续会补充SpringBoot中如何操作RocketMQ,万事万物都是先易后难,先简单后复杂。不说那么多了,下面通过实战案例为大家演示,如果帮助到了你,欢迎点赞  + 评论 + 关注 + 转发 + 收藏,让我们一起进步!

1.2、项目概览

1.3、公共代码

1.3.1、pom

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

	<dependency>
	  <groupId>junit</groupId>
	  <artifactId>junit</artifactId>
	  <version>4.13.2</version>
	  <scope>test</scope>
	</dependency>
	<dependency>
	  <groupId>com.alibaba</groupId>
	  <artifactId>fastjson</artifactId>
	  <version>2.0.25</version>
	</dependency>
	<dependency>
	  <groupId>cn.hutool</groupId>
	  <artifactId>hutool-all</artifactId>
	  <version>5.8.16</version>
	</dependency>
	<dependency>
	  <groupId>org.apache.commons</groupId>
	  <artifactId>commons-collections4</artifactId>
	  <version>4.4</version>
	</dependency>
	<dependency>
	  <groupId>org.apache.commons</groupId>
	  <artifactId>commons-lang3</artifactId>
	  <version>3.12.0</version>
	</dependency>

	<!-- 普通maven项目中使用Sl4j注解 -->
	<dependency>
	  <groupId>org.projectlombok</groupId>
	  <artifactId>lombok</artifactId>
	  <version>1.18.22</version>
	</dependency>
	<dependency>
	  <groupId>org.slf4j</groupId>
	  <artifactId>slf4j-api</artifactId>
	  <version>1.7.32</version>
	</dependency>
	<dependency>
	  <groupId>ch.qos.logback</groupId>
	  <artifactId>logback-classic</artifactId>
	  <version>1.2.10</version>
	</dependency>
</dependencies>

1.3.2、RocketMQConstant

/**
 * @Author: 一叶浮萍归大海
 * @Date: 2023/12/25 09:13
 * @Description: RocketMQ常量信息
 */
public class RocketMQConstant {

    /**
     * 配置RocketMQ NameSrv的地址
     */
    public static final String NAME_SERVER_ADDR = "<your MQ IP>:9876";

}

1.4、发送 & 接收同步消息

1.4.1、消息模型

1.4.2、特点

        同步消息有一个最大的特点是:生产者发送完消息后,服务端需返回一个消息给生产者,用于告知生产者当前消息的状态,这种方式非常的安全,但是性能上却没那么高了,而且在RocketMQ的集群模式下,需要等到所有的从机都复制了消息之后才会返回,所以一般对于重要的消息采用同步消息比较好。

1.4.3、Demo01MQTestApp

/**
 * @Author : 一叶浮萍归大海
 * @Date: 2023/12/24 23:47
 * @Description: 发送 & 接收同步消息
 */
@Slf4j
public class Demo01MQTestApp {


    /**
     * 发送同步消息
     */
    @Test
    public void demo1Producer() throws Exception {
        // 1、创建一个生产者
        DefaultMQProducer producer = new DefaultMQProducer("sync-producer-group");

        // 2、连接NameServer
        producer.setNamesrvAddr(RocketMQConstant.NAME_SERVER_ADDR);

        // 3、启动
        producer.start();

        // 4、创建消息
        Message message = new Message("sync-topic","这是一个同步消息".getBytes(StandardCharsets.UTF_8));

        // 5、发送消息
        SendResult result = producer.send(message);
        log.info("demo1Producer result:{}",JSON.toJSONString(result));
        log.info("【demo1Producer】发送消息成功");

        // 6、关闭生产者
        producer.shutdown();
    }
    /**
     * 接收同步消息(Push方式)
     */
    @Test
    public void demo1PushConsumer() throws Exception {
        // 1、创建一个消费者
        DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("sync-consumer-group");
        // 2、连接NameServer
        consumer.setNamesrvAddr(RocketMQConstant.NAME_SERVER_ADDR);
        // 3、订阅消息,*表示订阅该主题所有的消息
        consumer.subscribe("sync-topic","*");
        // 4、设置监听器(采用异步回调方式,一直监听)
        consumer.registerMessageListener(new MessageListenerConcurrently() {
            @Override
            public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
                // 业务逻辑
                log.info("我是消费者【demo1PushConsumer】");
                for (MessageExt message : msgs) {
                    log.info("我是消费者【demo1PushConsumer】,我收到的消息是:{}", StrUtil.utf8Str(message.getBody()));
                }

                /**
                 * 返回值:消费消息成功与否
                 *      CONSUME_SUCCESS:表明消费成功,消息会从MQ出队
                 *      RECONSUME_LATER:表明消费失败,消息会重新回到队里,过一会儿再重新投递出来给当前消费者或者其他消费者
                 */
                return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
            }
        });
        // 5、启动
        consumer.start();
        log.info("【demo1PushConsumer】启动成功,正在等待接收消息...");

        // 6、挂起当前JVM
        System.in.read();
    }

}

1.4.4、测试

        先后运行demo1PushConsumer和demo1Producer,观察控制台日志:

### RocketMQ 消息队列实战使用教程 #### 1. 创建生产者并发送消息RocketMQ 中,可以通过 `DefaultMQProducer` 类来创建一个生产者实例,并设置其名称服务器地址以及指定的主题(Topic)。以下是创建生产者的代码示例: ```java import org.apache.rocketmq.client.producer.DefaultMQProducer; import org.apache.rocketmq.common.message.Message; public class Producer { public static void main(String[] args) throws Exception { // 创建生产者实例并指定生产者组名 DefaultMQProducer producer = new DefaultMQProducer(&quot;YourProducerGroup&quot;); // 设置 NameServer 地址 producer.setNamesrvAddr(&quot;localhost:9876&quot;); // 启动生产者 producer.start(); // 构造消息对象 Message message = new Message(&quot;YourTopic&quot;, &quot;TagA&quot;, (&quot;Hello RocketMQ&quot;).getBytes()); // 发送同步消息 producer.send(message); // 关闭生产者 producer.shutdown(); } } ``` 上述代码展示了如何通过 Java API 来实现一条简单消息发送操作[^1]。 --- #### 2. 创建消费者并接收消息 为了消费来自主题的消息,可以利用 `DefaultMQPushConsumer` 类构建消费者实例。下面是一个完整的消费者配置与监听逻辑的例子: ```java 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.client.consumer.DefaultMQPushConsumer; public class Consumer { public static void main(String[] args) throws MQClientException { // 初始化消费者实例 DefaultMQPushConsumer consumer = new DefaultMQPushConsumer(&quot;YourConsumerGroup&quot;); // 配置 NameServer 地址 consumer.setNamesrvAddr(&quot;localhost:9876&quot;); // 订阅特定主题下的标签 consumer.subscribe(&quot;YourTopic&quot;, &quot;*&quot;); // 注册消息监听器 consumer.registerMessageListener((msgs, context) -&gt; { msgs.forEach(msg -&gt; System.out.printf(&quot;%s Receive New Messages: %s %n&quot;, Thread.currentThread().getName(), new String(msg.getBody()))); // 返回成功状态 return ConsumeConcurrentlyStatus.CONSUME_SUCCESS; }); // 开启消费者服务 consumer.start(); } } ``` 此部分实现了基本的消息订阅功能,并设置了回调函数处理接收到的数据流[^2]。 --- #### 3. 幂等性保障机制 由于分布式环境下可能存在重复投递的情况,在设计业务逻辑时需考虑消费端是否具备幂等功能。例如更新数据库记录或者累加计数器场景下应避免因重试而导致数据异常变化。具体做法如下所示: - **唯一标识符**:每条消息附加唯一的 ID 字段; - **去重表/缓存层校验**:首次执行写入动作前先查询目标资源是否存在相同键值项;如果存在则跳过后续流程直接返回成功响应。 这种策略能够有效减少不必要的计算开销同时提高系统的可靠性水平[^3]。 --- #### 4. 主题管理界面操作指南 对于初学者来说除了编码之外还需要熟悉运维方面的知识比如新增自定义 topic 。一般情况下我们可以在 web 控制台上完成此类任务而无需修改底层程序文件结构。步骤描述如下: 1. 登录到 RocketMQ 管理后台找到左侧菜单中的 &ldquo;Topic 管理&rdquo; 菜单项。 2. 切换至对应集群分区后点击顶部按钮触发新建对话框填写必要参数提交保存即可生效[^4]。 以上就是关于 rocket mq 基础入门级应用开发指导文档希望对你有所帮助! ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值