Apache RocketMQ官方文档中文精简版-有序的消息

RocketMQ 使用FIFO顺序，提供有序的消息。

下面的示例，演示了如何发送/接收全局的和部分的有序消息。

发送消息的示例代码

public class OrderedProducer {
    public static void main(String[] args) throws Exception {
        //Instantiate with a producer group name.
        MQProducer producer = new DefaultMQProducer("example_group_name");
        //Launch the instance.
        producer.start();
        String[] tags = new String[] {"TagA", "TagB", "TagC", "TagD", "TagE"};
        //循环有序地发送100条消息
        for (int i = 0; i < 100; i++) {
            int orderId = i % 10;
            //Create a message instance, specifying topic, tag and message body.
            Message msg = new Message("TopicTestjjj", tags[i % tags.length], "KEY" + i,
                    ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET));
            //调用生产者的send方法，指定Message实例、MessageQueueSelector实例和orderId为参数
            SendResult sendResult = producer.send(msg, new MessageQueueSelector() {
            @Override
            public MessageQueue select(List<MessageQueue> mqs, Message msg, Object arg) {
                //arg参数用来定位消息在队列中的位置，便于获取消息
                Integer id = (Integer) arg;
                int index = id % mqs.size();
                return mqs.get(index);
            }
            }, orderId);

            System.out.printf("%s%n", sendResult);
        }
        //server shutdown
        producer.shutdown();
    }
}

消息订阅的示例代码

public class OrderedConsumer {
    public static void main(String[] args) throws Exception {
        //创建消费者实例
        DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("example_group_name");
        //设置Consumer第一次启动时，从队列头部开始消费，之后按上次消费的位置继续消费
        consumer.setConsumeFromWhere(ConsumeFromWhere.CONSUME_FROM_FIRST_OFFSET);
        //订阅主题为TopicTest的，标签为TagA、TagC或TagD的消息
        consumer.subscribe("TopicTest", "TagA || TagC || TagD");
        //用MessageListenerOrderly来注册消息监听器，确保有序地消费
        consumer.registerMessageListener(new MessageListenerOrderly() {

            AtomicLong consumeTimes = new AtomicLong(0);
            @Override
            public ConsumeOrderlyStatus consumeMessage(List<MessageExt> msgs,
                                                       ConsumeOrderlyContext context) {
                context.setAutoCommit(false);
                System.out.printf(Thread.currentThread().getName() + " Receive New Messages: " + msgs + "%n");
                //comsumeTimes记录消费次数，每消费一次，原子操作+1
                this.consumeTimes.incrementAndGet();
                if ((this.consumeTimes.get() % 2) == 0) {
                    //演示返回成功状态
                    return ConsumeOrderlyStatus.SUCCESS;
                } else if ((this.consumeTimes.get() % 3) == 0) {
                    //演示返回回滚状态
                    return ConsumeOrderlyStatus.ROLLBACK;
                } else if ((this.consumeTimes.get() % 4) == 0) {
                    //演示返回提交状态
                    return ConsumeOrderlyStatus.COMMIT;
                } else if ((this.consumeTimes.get() % 5) == 0) {
                    //演示返回暂停状态，当前队列暂停3秒
                    context.setSuspendCurrentQueueTimeMillis(3000);
                    return ConsumeOrderlyStatus.SUSPEND_CURRENT_QUEUE_A_MOMENT;
                }
                return ConsumeOrderlyStatus.SUCCESS;

            }
        });
        //启动消费者
        consumer.start();

        System.out.printf("Consumer Started.%n");
    }
}