44、SpringCloudAlibaba实战:消息队列:完善rocketmq-consumer-example项目

补齐 RocketMQ 经典客户端消费入口,说明组、topic、关闭和重试边界,明确本轮仅编译未连接 broker。

简明结论

完整监听器需要明确客户端类型和业务成功边界;编译通过不能冒充 broker 投递或旧 binder 集成验证。

原 rocketmq-consumer-example 资料只保留了部分绑定配置和截图,缺少完整监听器。先确认使用的是旧 Spring Cloud Stream binder、经典 Java 客户端还是新版 gRPC SDK,不能只凭相近类名混用配置。

完整的经典 Java 消费入口

下面新增例子使用 rocketmq-client 5.3.1 中的 DefaultMQPushConsumer 经典客户端 API,已随共享 POM 编译;没有启动 NameServer 或 broker。它不代表已经修复或运行了旧 Stream binder 工程,也不是新版 gRPC SDK 的用法。

package site;

import java.nio.charset.StandardCharsets;
import java.util.concurrent.CountDownLatch;
import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;

public class RocketConsumerExample {
  public static void main(String[] args) throws Exception {
    if (args.length!=3) throw new IllegalArgumentException("Expected: nameserver group topic");
    var consumer=new DefaultMQPushConsumer(args[1]);
    consumer.setNamesrvAddr(args[0]);
    consumer.subscribe(args[2],"*");
    consumer.registerMessageListener((MessageListenerConcurrently)(messages,context) -> {
      try {
        for (var message:messages) {
          String value=new String(message.getBody(),StandardCharsets.UTF_8);
          System.out.println("message-id="+message.getMsgId()+"; value="+value);
        }
        return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
      } catch (RuntimeException failed) { return ConsumeConcurrentlyStatus.RECONSUME_LATER; }
    });
    var stop=new CountDownLatch(1);
    Runtime.getRuntime().addShutdownHook(new Thread(() -> {consumer.shutdown();stop.countDown();}));
    consumer.start();
    try { stop.await(); } finally { consumer.shutdown(); }
  }
}

在自己的测试环境运行前

先记录 NameServer 与 broker 的版本、客户端兼容性、可访问的 advertised 地址、topic、消费组、权限及生产者。共享 Maven 工程通过 test-compile 可以核对这份放在 src/test/java/site 的示例;实际运行还需要把测试类和依赖放入 classpath,并向 main 传入 nameserver、group、topic 三个参数。不要把本机 127.0.0.1 无条件复制给远端客户端。

程序启动后等待关闭信号,由 shutdown hook 释放消费者;收到一批消息后逐条解码并报告结果。打印消息只代表这个示例的处理动作,真实业务应在写入完成后返回成功;部分业务已成功而整批重试时仍需幂等,不能靠返回 CONSUME_SUCCESS 宣称所有业务恰好一次。

以下为待测试环境执行的 POSIX shell 命令,不是本轮已验证的 broker 运行步骤。先按自己的测试环境核对三个参数;Windows 的 classpath 分隔符需要相应调整。

mvn test-compile dependency:build-classpath -DincludeScope=test -Dmdep.outputFile=target/phase6-classpath.txt
java -cp "target/test-classes:$(cat target/phase6-classpath.txt)" site.RocketConsumerExample 127.0.0.1:9876 phase6-test-group phase6-test-topic

本轮验证范围

实际完成的是 Java 编译与客户端 API 签名检查,未验证 broker 投递、重试、tag 过滤、顺序消费、认证或旧 binder 属性绑定。没有真实投递输出,所以不提供模拟的成功消费截图。旧资料中两组 input 绑定、orderly 与 tagStr 参数仅保留作历史线索,后续应在明确版本的独立环境中复核。

下一步阅读

原资料片段(未重建原环境)

下方保留原资料的上下文、示例与截图;本轮验证只对应上方新增文件,未将旧运行结果记为本轮结果。

完善 rocketmq-consumer-example 项目

    • 1.添加配置文件
  • 2.添加一个 Sink
  • 6.3创建消息的监听器
  • 4.主动去 mq 服务器拉起消息
  • 5.模型类
  • 6.配置类
  • 7.启动类

1.添加配置文件

 

  • 内容如下:
spring.cloud.stream.rocketmq.binder.name-server=127.0.0.1:9876

spring.cloud.stream.bindings.input1.destination=test-topic
spring.cloud.stream.bindings.input1.content-type=text/plain
spring.cloud.stream.bindings.input1.group=test-group1
spring.cloud.stream.rocketmq.bindings.input1.consumer.orderly=true

spring.cloud.stream.bindings.input2.destination=test-topic
spring.cloud.stream.bindings.input2.content-type=text/plain
spring.cloud.stream.bindings.input2.group=test-group2
spring.cloud.stream.rocketmq.bindings.input2.consumer.orderly=false
spring.cloud.stream.rocketmq.bindings.input2.consumer.tags=tagStr
spring.cloud