MQ收发顺序消息

发送和订阅顺序消息，请使用 Java SDK 1.2.7 及以上版本。

顺序消息是 MQ 提供的一种按照顺序进行发布消费的消息类型，适用由于需要严格按照先进先出的原则进行消息发布和消费的场景。详情请参考顺序消息文档。

全局顺序消息和分区顺序消息的收发方式基本一样，具体请参考以下示例代码。

发送消息示例代码：

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

订阅消息示例代码：

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. properties.put(PropertyKeyConst.ConsumerId, "XXX");// 您在控制台创建的 Consumer ID
19. properties.put(PropertyKeyConst.AccessKey, "XXX");// AccessKey 阿里云身份验证，在阿里云服务器管理控制台创建
20. properties.put(PropertyKeyConst.SecretKey, "XXX");// SecretKey 阿里云身份验证，在阿里云服务器管理控制台创建
21. //公有云生产环境：http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal
22. //公有云公测环境：http://onsaddr-internet.aliyun.com/rocketmq/nsaddr4client-internet
23. //杭州金融云环境：http://jbponsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal
24. //杭州深圳云环境：http://mq4finance-sz.addr.aliyun.com:8080/rocketmq/nsaddr4client-internal
25. properties.put(PropertyKeyConst.ONSAddr,
26. "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");//此处以公有云生产环境为例
27. properties.put(PropertyKeyConst.SuspendTimeMillis, "100"); // 顺序消息消费失败进行重试前的等待时间 单位(毫秒)
28. properties.put(PropertyKeyConst.MaxReconsumeTimes, "20"); // 消息消费失败时的最大重试次数
30. // 在订阅消息前，必须调用 start 方法来启动 Consumer，只需调用一次即可。
31. OrderConsumer consumer = ONSFactory.createOrderedConsumer(properties);
33. consumer.subscribe(
34. // Message所属的Topic
35. "Jodie_Order_Topic",
36. // 订阅指定Topic下的Tags：
37. // 1. * 表示订阅所有消息
38. // 2. TagA || TagB || TagC 表示订阅TagA 或 TagC 或 TagD 的消息
39. "*",
40. new MessageOrderListener() {
41. /**
42. * 1. 消息消费处理失败或者处理出现异常，返回OrderAction.Suspend

43. * 2. 消息处理成功，返回与返回OrderAction.Success
44. */
45. @Override
46. public OrderAction consume(Message message, ConsumeOrderContext context) {
47. System.out.println(message);
48. return OrderAction.Success;
49. }
50. });
52. consumer.start();
53. }
54. }