本文介绍如何通过 MQ SDK 进行消息订阅。
请确保同一个 Consumer ID 下所有 Consumer 实例的订阅关系保持一致,具体请参考
订阅关系一致文档。
TCP 接入点域名,请
前往查看。
MQ 支持两种订阅方式。
集群订阅:同一个 Consumer ID 所标识的所有 Consumer 平均分摊消费消息。例如某个 Topic 有 9 条消息,一个 Consumer ID 有 3 个 Consumer 实例,那么在集群消费模式下每个实例平均分摊,只消费其中的 3 条消息。
-
// 集群订阅方式设置(不设置的情况下,默认为集群订阅方式)
- properties.put(PropertyKeyConst.MessageModel, PropertyValueConst.CLUSTERING);
广播订阅:同一个 Consumer ID 所标识的所有 Consumer 都会各自消费某条消息一次。例如某个 Topic 有 9 条消息,一个 Consumer ID 有 3 个 Consumer 实例,那么在广播消费模式下每个实例都会各自消费 9 条消息。
-
// 广播订阅方式设置
- properties.put(PropertyKeyConst.MessageModel, PropertyValueConst.BROADCASTING);
示例代码
- import com.aliyun.openservices.ons.api.Action;
- import com.aliyun.openservices.ons.api.ConsumeContext;
- import com.aliyun.openservices.ons.api.Consumer;
- import com.aliyun.openservices.ons.api.Message;
- import com.aliyun.openservices.ons.api.MessageListener;
- import com.aliyun.openservices.ons.api.ONSFactory;
- import com.aliyun.openservices.ons.api.PropertyKeyConst;
- import java.util.Properties;
- public class ConsumerTest {
- public static void main(String[] args) {
- Properties properties = new Properties();
- // 您在控制台创建的 Consumer ID
- properties.put(PropertyKeyConst.ConsumerId, "XXX");
- // AccessKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.AccessKey, "XXX");
- // SecretKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.SecretKey, "XXX");
- // 设置 TCP 接入域名(此处以公共云生产环境为例)
- properties.put(PropertyKeyConst.ONSAddr,
- "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
- // 集群订阅方式 (默认)
- // properties.put(PropertyKeyConst.MessageModel, PropertyValueConst.CLUSTERING);
- // 广播订阅方式
- // properties.put(PropertyKeyConst.MessageModel, PropertyValueConst.BROADCASTING);
- Consumer consumer = ONSFactory.createConsumer(properties);
- consumer.subscribe("TopicTestMQ", "TagA||TagB", new MessageListener() { //订阅多个Tag
- public Action consume(Message message, ConsumeContext context) {
- System.out.println("Receive: " + message);
- return Action.CommitMessage;
- }
- });
- //订阅另外一个Topic
- consumer.subscribe("TopicTestMQ-Other", "*", new MessageListener() { //订阅全部Tag
- public Action consume(Message message, ConsumeContext context) {
- System.out.println("Receive: " + message);
- return Action.CommitMessage;
- }
- });
- consumer.start();
- System.out.println("Consumer Started");
- }
- }
注意:广播消费模式下,控制台无法设置消息堆积报警,无法进行消息堆积查询。因此,也可以创建多个 Consumer ID 来达到广播模式的效果。详情请参考文档
多个 Consumer ID 模式。