【RocketMQ】6. 过滤消息，事务消息

一、过滤消息

1 .Tag过滤

在大多数情况下，TAG是一个简单而有用地设计，其可以来选择需要地消息。例如

DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("CID_EXAMPLE");
consumer.subscribe("TOPIC", "TAGA || TAGB || TAGC");

消费者将接受包含TAGA或TAGB或者TAGC地消息。但是限制知识一个消息只能有一个标签，这对于复杂地场景可能不起作用，在这种情况下，可以使用SQL表达式筛选消息。SQL特性可以通过发送消息时地属性进行计算。在RocketMQ定义的语法下，可以实现一些简单的逻辑，下面时一个例子

------------
| message  |
|----------|  a > 5 AND b = 'abc'
| a = 10   |  --------------------> Gotten
| b = 'abc'|
| c = true |
------------
------------
| message  |
|----------|   a > 5 AND b = 'abc'
| a = 1    |  --------------------> Missed
| b = 'abc'|
| c = true |
------------

2. SQL基本语法

RocketMQ只定义了一些基本语法来支持这个特性。你也可以很容易的扩展它

• 数值比较，比如: >,>=,<,<=,BETWEEN,=;
• 字符比较，比如:=,<>,IN;
• IS NULL或者IS NOT NULL;
• 逻辑符号AND,OR,NOT;

常量支持类型为

• 数值，比如 123 3.1415
• 字符，比如’abc’,必须用单引号包裹起来
• NULL 特殊的常量
• 布尔值，TRUE或FALSE

只有使用push模式的消费者才能使用SQL92标准的sql语句，接口如下

3. 实现消费者

发送消息时，你能通过pushUserProperty来设置消息的属性

DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
producer.start();
Message msg = new Message("TopicTest",
   tag,
   ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET)
);
// 设置一些属性
msg.putUserProperty("a", String.valueOf(i));
SendResult sendResult = producer.send(msg);

producer.shutdown();

4. 实现消息消费者

用MessageSelector.bySql来使用sql筛选消息

DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name_4");
// 只有订阅的消息有这个属性a, a >=0 and a <= 3
consumer.subscribe("TopicTest", MessageSelector.bySql("a between 0 and 3");
consumer.registerMessageListener(new MessageListenerConcurrently() {
   @Override
   public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
       return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
   }
});
consumer.start();

二、事务消息

流程分析

上图说明了事务消息的大致方案，其中分为两个流程：正常事务消息的发送及提交、事务消息的补偿流程

1. 事务消息发送及提交

1. 发送消息（half消息)
2. 服务端响应消息写入结果
3. 根据发送结果执行本地事务（如果写入失败，此时half消息对业务不可见，本地逻辑不执行）
4. 根据本地事务状态执行Commit或者Rollback（Commit操作生成消息索引，消息对消费者可见）

2. 事务补偿

1. 对没有Commit/Rollback的事务消息(pending状态的消息），从服务端发起一次“回查”
2. Producer收到会查消息，重新Commit或者Rollback

其中，补偿阶段用于解决消息Commit或者Rollback发生超时会哦这失败的情况

3. 事务消息状态

事务消息共有三种状态，提交状态，回滚状态，中间状态

• TransactionStatus.CommutTransaction:提交事务，它允许消费者消费此消息
• TransactionStatus.RollbackTransaction: 回滚事务，它代表该消息将被删除，不允许被消费。
• TransactionStatus.Unknown: 中间状态，它代表需要检查消息队列来确定状态。

4. 创建事务性生产者

使用TransactionMQProducer类创建生产者，并指定唯一的ProducerGroup,就可以设置自定义线程池来处理这些检查请求，执行本地食物后，需要根据执行结果对消息队列进行回复。回传的事务状态在请参考前一节

public class Producer {

    public static void main(String[] args) throws Exception {
        //1.创建消息生产者producer，并制定生产者组名
        TransactionMQProducer producer = new TransactionMQProducer("group5");
        //2.指定Nameserver地址
        producer.setNamesrvAddr("39.96.86.4:9876;59.110.158.93:9876");

        //添加事务监听器
        producer.setTransactionListener(new TransactionListener() {
            /**
             * 在该方法中执行本地事务
             * @param msg
             * @param arg
             * @return
             */
            @Override
            public LocalTransactionState executeLocalTransaction(Message msg, Object arg) {
                if (StringUtils.equals("TAGA", msg.getTags())) {
                    return LocalTransactionState.COMMIT_MESSAGE;
                } else if (StringUtils.equals("TAGB", msg.getTags())) {
                    return LocalTransactionState.ROLLBACK_MESSAGE;
                } else if (StringUtils.equals("TAGC", msg.getTags())) {
                    return LocalTransactionState.UNKNOW;
                }
                return LocalTransactionState.UNKNOW;
            }

            /**
             * 该方法时MQ进行消息事务状态回查
             * @param msg
             * @return
             */
            @Override
            public LocalTransactionState checkLocalTransaction(MessageExt msg) {
                System.out.println("消息的Tag:" + msg.getTags());
                return LocalTransactionState.COMMIT_MESSAGE;
            }
        });

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

        String[] tags = {"TAGA", "TAGB", "TAGC"};

        for (int i = 0; i < 3; i++) {
            //4.创建消息对象，指定主题Topic、Tag和消息体
            /**
             * 参数一：消息主题Topic
             * 参数二：消息Tag
             * 参数三：消息内容
             */
            Message msg = new Message("TransactionTopic", tags[i], ("Hello World" + i).getBytes());
            //5.发送消息
            SendResult result = producer.sendMessageInTransaction(msg, null);
            //发送状态
            SendStatus status = result.getSendStatus();

            System.out.println("发送结果:" + result);

            //线程睡1秒
            TimeUnit.SECONDS.sleep(2);
        }

        //6.关闭生产者producer
        //producer.shutdown();
    }
}

5. 实现事务的监听接口

当发送半消息成功时，我们使用executeLocalTransaction方法来执行本地事务。它返回前一节提到的三个事务状态之一。checkLocalTranscation方法用于检查本地事务状态，并回应消息队列的检查请求。它也是返回前一节中提到的三个事务状态之一。

6. 使用限制

1. 事务消息不支持延时消息和批量消息
2. 为了避免单个消息被金叉太多次而导致版队列消息记类，我们默认将单个i奥西的检查次数限制为15次，但是用户可以通过Brocker配置文件的transactionCheckMax参数来修改此限制，如果已经检查某条消息超过N次的话（ N = transactionCheckMax ） 则 Broker 将丢弃此消息，并在默认情况下同时打印错误日志。用户可以通过重写 AbstractTransactionCheckListener 类来修改这个行为。
3. 事务消息将在 Broker 配置文件中的参数 transactionMsgTimeout 这样的特定时间长度之后被检查。当发送事务消息时，用户还可以通过设置用户属性 CHECK_IMMUNITY_TIME_IN_SECONDS 来改变这个限制，该参数优先于 transactionMsgTimeout 参数。
4. 事务性消息可能不止一次被检查或消费。
   提交给用户的目标主题消息可能会失败，目前这依日志的记录而定。它的高可用性通过 RocketMQ 本身的高可用性机制来保证，如果希望确保事务消息不丢失、并且事务完整性得到保证，建议使用同步的双重写入机制。
5. 事务消息的生产者 ID 不能与其他类型消息的生产者 ID 共享。与其他类型的消息不同，事务消息允许反向查询、MQ服务器能通过它们的生产者 ID 查询到消费者。