Java SDK 如何顺序消息收发

发送和订阅顺序消息，请使用 Java SDK 1.2.7 及以上版本。
顺序消息是 MQ 提供的一种按照顺序进行发布消费的消息类型，适用由于需要严格按照先进先出的原则进行消息发布和消费的场景。详情请参考 顺序消息文档。
全局顺序消息和分区顺序消息的收发方式基本一样，具体请参考以下示例代码。
TCP 接入点域名，请 前往查看。
发送消息示例代码：

1. package com.aliyun.openservices.ons.example.order;
3. import com.aliyun.openservices.ons.api.Message;
4. import com.aliyun.openservices.ons.api.ONSFactory;
5. import com.aliyun.openservices.ons.api.PropertyKeyConst;
6. import com.aliyun.openservices.ons.api.SendResult;
7. import com.aliyun.openservices.ons.api.order.OrderProducer;
9. import java.util.Properties;
12. public class ProducerClient {
14.     public static void main(String[] args) {
15.         Properties properties = new Properties();
16.         // 您在控制台创建的 Producer ID
17.         properties.put(PropertyKeyConst.ProducerId, "XXX");
18.         // AccessKey 阿里云身份验证，在阿里云服务器管理控制台创建
19.         properties.put(PropertyKeyConst.AccessKey, "XXX");
20.         // SecretKey 阿里云身份验证，在阿里云服务器管理控制台创建
21.         properties.put(PropertyKeyConst.SecretKey, "XXX");
22.         // 设置 TCP 接入域名（此处以公共云生产环境为例）
23.         properties.put(PropertyKeyConst.ONSAddr,
24.           "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
25.         OrderProducer producer = ONSFactory.createOrderProducer(properties);
26.         // 在发送消息前，必须调用 start 方法来启动 Producer，只需调用一次即可。
27.         producer.start();
28.         for (int i = 0; i < 1000; i++) {
29.             String orderId = "biz_" + i % 10;
30.             Message msg = new Message(//
31.                     // Message所属的Topic
32.                     "Order_global_topic",
33.                     // Message Tag, 可理解为Gmail中的标签，对消息进行再归类，方便Consumer指定过滤条件在MQ服务器过滤
34.                     "TagA",
35.                     // Message Body 可以是任何二进制形式的数据， MQ 不做任何干预，需要 Producer 与 Consumer 协商好一致的序列化和反序列化方式
36.                     "send order global msg".getBytes()
37.             );
38.             // 设置代表消息的业务关键属性，请尽可能全局唯一。
39.             // 以方便您在无法正常收到消息情况下，可通过 MQ 控制台查询消息并补发。
40.             // 注意：不设置也不会影响消息正常收发
41.             msg.setKey(orderId);
42.             // 分区顺序消息中区分不同分区的关键字段，sharding key于普通消息的key是完全不同的概念。
43.             // 全局顺序消息，该字段可以设置为任意非空字符串。
44.             String shardingKey = String.valueOf(orderId);
45.             // 发送消息，只要不抛异常就是成功
46.             SendResult sendResult = producer.send(msg, shardingKey);
47.             System.out.println("Message Id:" + sendResult.getMessageId());
48.         }
49.         // 在应用退出前，销毁Producer对象
50.         // 注意：如果不销毁也没有问题
51.         producer.shutdown();
52.     }
54. }

1. package com.aliyun.openservices.ons.example.order;
3. import com.aliyun.openservices.ons.api.Message;
4. import com.aliyun.openservices.ons.api.ONSFactory;
5. import com.aliyun.openservices.ons.api.PropertyKeyConst;
6. import com.aliyun.openservices.ons.api.order.ConsumeOrderContext;
7. import com.aliyun.openservices.ons.api.order.MessageOrderListener;
8. import com.aliyun.openservices.ons.api.order.OrderAction;
9. import com.aliyun.openservices.ons.api.order.OrderConsumer;
11. import java.util.Properties;
14. public class ConsumerClient {
16.     public static void main(String[] args) {
17.         Properties properties = new Properties();
18.         // 您在控制台创建的 Consumer ID
19.         properties.put(PropertyKeyConst.ConsumerId, "XXX");
20.         // AccessKey 阿里云身份验证，在阿里云服务器管理控制台创建
21.         properties.put(PropertyKeyConst.AccessKey, "XXX");
22.         // SecretKey 阿里云身份验证，在阿里云服务器管理控制台创建
23.         properties.put(PropertyKeyConst.SecretKey, "XXX");
24.         // 设置 TCP 接入域名（此处以公共云生产环境为例）
25.         properties.put(PropertyKeyConst.ONSAddr,
26.           "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
27.           // 顺序消息消费失败进行重试前的等待时间 单位(毫秒)
28.         properties.put(PropertyKeyConst.SuspendTimeMillis, "100");
29.         // 消息消费失败时的最大重试次数
30.         properties.put(PropertyKeyConst.MaxReconsumeTimes, "20");
32.         // 在订阅消息前，必须调用 start 方法来启动 Consumer，只需调用一次即可。
33.         OrderConsumer consumer = ONSFactory.createOrderedConsumer(properties);
35.         consumer.subscribe(
36.                 // Message所属的Topic
37.                 "Jodie_Order_Topic",
38.                 // 订阅指定Topic下的Tags：
39.                 // 1. * 表示订阅所有消息
40.                 // 2. TagA || TagB || TagC 表示订阅TagA 或 TagC 或 TagD 的消息
41.                 "*",
42.                 new MessageOrderListener() {
43.                     /**
44.                      * 1. 消息消费处理失败或者处理出现异常，返回OrderAction.Suspend<br>
45.                      * 2. 消息处理成功，返回与返回OrderAction.Success
46.                      */
47.                     @Override
48.                     public OrderAction consume(Message message, ConsumeOrderContext context) {
49.                         System.out.println(message);
50.                         return OrderAction.Success;
51.                     }
52.                 });
54.         consumer.start();
55.     }
56. }