新功能发布记录
公告
发送与接收过滤消息
操作场景
本文以调用 Java SDK 为例介绍通过开源 SDK 实现过滤消息收发的操作过程。目前支持两种，分别是Tag 和 SQL 方式。
前提条件
已参考 SDK 概述，获取相关的客户端连接参数
下载 Demo
TAG使用步骤
创建生产者消费者的基础代码不再赘述，可以参考普通消息的发送和接收即可。
对于生产消息，主要是在构造消息体的时候，带上TAG。
对于消费消息，主要是订阅的时候，带上单个TAG 或者 * 或者多个TAG表达式。
步骤1：生产消息
发送消息
发送代码和简单的消息没有区别 主要是在构造消息体的时候，带上TAG，仅允许一个。
int totalMessagesToSend = 5;for (int i = 0; i < totalMessagesToSend; i++) {Message msg = new Message(TOPIC_NAME, "Tag1", "Hello RocketMQ.".getBytes(StandardCharsets.UTF_8));// 发送消息SendResult sendResult = producer.send(msg);System.out.println("sendResult = " + sendResult);}
步骤2：消费消息
订阅消息。
// 订阅topic 订阅所有的TAGpushConsumer.subscribe(topic_name, "*");//订阅指定的TAG//pushConsumer.subscribe(TOPIC_NAME, "Tag1");//订阅多个TAG//pushConsumer.subscribe(TOPIC_NAME, "Tag1||Tag2");// 注册回调实现类来处理从broker拉取回来的消息pushConsumer.registerMessageListener((MessageListenerConcurrently) (msgs, context) -> {// 消息处理逻辑System.out.printf("%s Receive New Messages: %s %n", Thread.currentThread().getName(), msgs);// 标记该消息已经被成功消费, 根据消费情况，返回处理状态return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;});// 启动消费者实例pushConsumer.start();
说明：
参数 | 说明 |
topic_name | Topic 的名称，在控制台 Topic 管理页面复制。 4.x虚拟集群/专享集群：此处需拼接命名空间名称，格式为 namespace全称%topic名称，例如 MQ_INSTxxx_aaa%TopicTest。4.x通用集群/5.x集群：此处无需拼接，填写 Topic 名称即可。  |
"*" | 订阅表达式如果为 null 或*表达式表示订阅全部，同时支持 "tag1 || tag2 || tag3" 标识订阅多个类型的 tag。 |
说明
SQL 使用步骤
创建生产者消费者的基础代码不再赘述，可以参考普通消息的发送和接收即可。
对于生产消息，主要是在构造消息体的时候，带上用户自定义的properties。
对于消费消息，主要是订阅的时候，带上对应的SQL表达式。
步骤1：生产消息
发送代码和简单的消息没有区别 主要是在构造消息体的时候，带上自定义属性，允许多个。
int totalMessagesToSend = 5;for (int i = 0; i < totalMessagesToSend; i++) {Message msg = new Message(TOPIC_NAME,"Hello RocketMQ.".getBytes(StandardCharsets.UTF_8));msg.putUserProperty("key1","value1");// 发送消息SendResult sendResult = producer.send(msg);System.out.println("sendResult = " + sendResult);}
步骤2：消费消息
对于消费消息，主要是订阅的时候，带上对应的SQL表达式，其他的和普通的没有区别。
pushConsumer.subscribe(TOPIC_NAME, MessageSelector.bySql("True"));// 订阅topic 订阅单个key的sql，最常用//pushConsumer.subscribe(TOPIC_NAME, MessageSelector.bySql("key1 IS NOT NULL AND key1='value1'"));//订阅多个属性//pushConsumer.subscribe(TOPIC_NAME, MessageSelector.bySql("key1 IS NOT NULL AND key2 IS NOT NULL AND key1='value1' AND key2='value2'"));// 注册回调实现类来处理从broker拉取回来的消息pushConsumer.registerMessageListener((MessageListenerConcurrently) (msgs, context) -> {// 消息处理逻辑System.out.printf("%s Receive New Messages: %s %n", Thread.currentThread().getName(), msgs);// 标记该消息已经被成功消费, 根据消费情况，返回处理状态return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;});// 启动消费者实例pushConsumer.start();
说明
文档反馈