MQ 发送消息有三种实现方式:可靠同步发送、可靠异步发送、单向(Oneway)发送。本文介绍了每种实现的原理、使用场景以及三种实现的异同,同时提供了代码示例以供参考。
注意:顺序消息只支持可靠同步发送。
可靠同步发送
原理:同步发送是指消息发送方发出数据后,会在收到接收方发回响应之后才发下一个数据包的通讯方式。
应用场景:适用于某些耗时非常短,但对可靠性要求并不高的场景,例如日志收集。
下表概括了三者的特点和主要区别。
示例代码
TCP 接入点域名,请
前往查看。
同步发送
- import com.aliyun.openservices.ons.api.Message;
- import com.aliyun.openservices.ons.api.Producer;
- import com.aliyun.openservices.ons.api.SendResult;
- import com.aliyun.openservices.ons.api.ONSFactory;
- import com.aliyun.openservices.ons.api.PropertyKeyConst;
- import java.util.Properties;
- public class ProducerTest {
- public static void main(String[] args) {
- Properties properties = new Properties();
- //您在控制台创建的Producer ID
- properties.put(PropertyKeyConst.ProducerId, "XXX");
- // AccessKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.AccessKey,"XXX");
- // SecretKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.SecretKey, "XXX");
- //设置发送超时时间,单位毫秒
- properties.setProperty(PropertyKeyConst.SendMsgTimeoutMillis, "3000");
- // 设置 TCP 接入域名(此处以公共云生产环境为例)
- properties.put(PropertyKeyConst.ONSAddr,
- "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
- Producer producer = ONSFactory.createProducer(properties);
- // 在发送消息前,必须调用start方法来启动Producer,只需调用一次即可
- producer.start();
- //循环发送消息
- for (int i = 0; i < 100; i++){
- Message msg = new Message( //
- // Message所属的Topic
- "TopicTestMQ",
- // Message Tag 可理解为Gmail中的标签,对消息进行再归类,方便Consumer指定过滤条件在MQ服务器过滤
- "TagA",
- // Message Body 可以是任何二进制形式的数据, MQ不做任何干预,
- // 需要Producer与Consumer协商好一致的序列化和反序列化方式
- "Hello MQ".getBytes());
- // 设置代表消息的业务关键属性,请尽可能全局唯一。
- // 以方便您在无法正常收到消息情况下,可通过阿里云服务器管理控制台查询消息并补发
- // 注意:不设置也不会影响消息正常收发
- msg.setKey("ORDERID_" + i);
- // 同步发送消息,只要不抛异常就是成功
- SendResult sendResult = producer.send(msg);
- System.out.println(sendResult);
- }
- // 在应用退出前,销毁Producer对象
- // 注意:如果不销毁也没有问题
- producer.shutdown();
- }
- }
异步发送
- import com.aliyun.openservices.ons.api.Message;
- import com.aliyun.openservices.ons.api.OnExceptionContext;
- import com.aliyun.openservices.ons.api.Producer;
- import com.aliyun.openservices.ons.api.SendCallback;
- import com.aliyun.openservices.ons.api.SendResult;
- import com.aliyun.openservices.ons.api.ONSFactory;
- import com.aliyun.openservices.ons.api.PropertyKeyConst;
- import java.util.Properties;
- public static void main(String[] args) {
- Properties properties = new Properties();
- // AccessKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.AccessKey, "DEMO_AK");
- // SecretKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.SecretKey, "DEMO_SK");
- //您在控制台创建的Producer ID
- properties.put(PropertyKeyConst.ProducerId, "DEMO_PID");
- //设置发送超时时间,单位毫秒
- properties.setProperty(PropertyKeyConst.SendMsgTimeoutMillis, "3000");
- // 设置 TCP 接入域名(此处以公共云生产环境为例)
- properties.put(PropertyKeyConst.ONSAddr,
- "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
- Producer producer = ONSFactory.createProducer(properties);
- // 在发送消息前,必须调用start方法来启动Producer,只需调用一次即可。
- producer.start();
- Message msg = new Message(
- // Message所属的Topic
- "TopicTestMQ",
- // Message Tag,可理解为Gmail中的标签,对消息进行再归类,方便Consumer指定过滤条件在MQ服务器过滤
- "TagA",
- // Message Body,任何二进制形式的数据,MQ不做任何干预,需要Producer与Consumer协商好一致的序列化和反序列化方式
- "Hello MQ".getBytes());
- // 设置代表消息的业务关键属性,请尽可能全局唯一。以方便您在无法正常收到消息情况下,可通过MQ控制台查询消息并补发。
- // 注意:不设置也不会影响消息正常收发
- msg.setKey("ORDERID_100");
- // 异步发送消息, 发送结果通过callback返回给客户端。
- producer.sendAsync(msg, new SendCallback() {
- @Override
- public void onSuccess(final SendResult sendResult) {
- // 消费发送成功
- System.out.println("send message success. topic=" + sendResult.getTopic() + ", msgId=" + sendResult.getMessageId());
- }
- @Override
- public void onException(OnExceptionContext context) {
- // 消息发送失败
- System.out.println("send message failed. topic=" + context.getTopic() + ", msgId=" + context.getMessageId());
- }
- });
- // 在callback返回之前即可取得msgId。
- System.out.println("send message async. topic=" + msg.getTopic() + ", msgId=" + msg.getMsgID());
- // 在应用退出前,销毁Producer对象。注意:如果不销毁也没有问题
- producer.shutdown();
- }
单向(Oneway)发送
- import com.aliyun.openservices.ons.api.Message;
- import com.aliyun.openservices.ons.api.Producer;
- import com.aliyun.openservices.ons.api.ONSFactory;
- import com.aliyun.openservices.ons.api.PropertyKeyConst;
- import java.util.Properties;
- public static void main(String[] args) {
- Properties properties = new Properties();
- // AccessKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.AccessKey, "DEMO_AK");
- // SecretKey 阿里云身份验证,在阿里云服务器管理控制台创建
- properties.put(PropertyKeyConst.SecretKey, "DEMO_SK");
- //您在控制台创建的Producer ID
- properties.put(PropertyKeyConst.ProducerId, "DEMO_PID");
- //设置发送超时时间,单位毫秒
- properties.setProperty(PropertyKeyConst.SendMsgTimeoutMillis, "3000");
- // 设置 TCP 接入域名(此处以公共云生产环境为例)
- properties.put(PropertyKeyConst.ONSAddr,
- "http://onsaddr-internal.aliyun.com:8080/rocketmq/nsaddr4client-internal");
- Producer producer = ONSFactory.createProducer(properties);
- // 在发送消息前,必须调用start方法来启动Producer,只需调用一次即可。
- producer.start();
- //循环发送消息
- for (int i = 0; i < 100; i++){
- Message msg = new Message(
- // Message所属的Topic
- "TopicTestMQ",
- // Message Tag,
- // 可理解为Gmail中的标签,对消息进行再归类,方便Consumer指定过滤条件在MQ服务器过滤
- "TagA",
- // Message Body
- // 任何二进制形式的数据,MQ不做任何干预,需要Producer与Consumer协商好一致的序列化和反序列化方式
- "Hello MQ".getBytes());
- // 设置代表消息的业务关键属性,请尽可能全局唯一。
- // 以方便您在无法正常收到消息情况下,可通过阿里云服务器管理控制台查询消息并补发。
- // 注意:不设置也不会影响消息正常收发
- msg.setKey("ORDERID_" + i);
- // oneway发送消息,只要不抛异常就是成功
- producer.sendOneway(msg);
- }
- // 在应用退出前,销毁Producer对象
- // 注意:如果不销毁也没有问题
- producer.shutdown();
- }