消息传递模块总览 - Overview

本分类做什么

两套模型：Pub/Sub（发布订阅） 与 MessageQueue（消息队列）。侧栏含 使用指南 与类型枚举页；API 以 PubSub* 与 MessageQueue* 为前缀，适合 进程内/插件支持的跨进程 解耦通信。与 远程调用 的 同步 RPC 不同：本分类偏 异步消息。

---

一、入门文档

文档	内容
PubSub使用指南	主题、订阅、发布、连接状态。
MessageQueue使用指南	声明、发布、消费、确认、拉取。

建议先读指南，再查具体 API 参数。

---

二、Pub/Sub：PubSub*

接口	差异
PubSubNew、PubSubFree	实例 生命周期。
PubSubSub、PubSubUnsub、PubSubUnsubAll	订阅/退订 主题。
PubSubPubText、PubSubPubBytes	发布 文本 或 二进制。
PubSubGetMyTopics、PubSubGetTopicSubCount	查询订阅关系。
PubSubGetNetStatus	连接/网络状态。

与 MQ 差异：多对多广播、无内置 持久化（以版本为准）；适合 事件通知。

---

三、消息队列：MessageQueue*

接口	环节
MessageQueueDeclare	声明 队列（名称、持久等，见详情页）。
MessageQueueClose	关闭 发布端（或某句柄，见详情页）。
MessageQueuePublishText、MessageQueuePublishBytes	生产 消息。
MessageQueueConsume	消费者 启动（回调驱动）。
MessageQueueCancel	取消消费。
MessageQueueAck、MessageQueueNack	确认/拒绝（可靠性）。
MessageQueuePull	主动拉取（与 Consume 推送对比）。

与 Pub/Sub 差异：队列 语义：通常 点对点、可 重试；Ack/Nack 保证投递。

---

四、类型与回调

文档/接口	用途
PubSub角色类型 - OLAPubSubType	发布者/订阅者等 角色枚举。
PubSub连接类型 - OLAPubSubConnectType	连接方式（内存/管道/TCP 等以详情为准）。
MessageQueueCallback - MessageQueueCallback	消费 回调签名。

---

五、快速选型

需求	建议
多模块广播「配置已更新」	Pub/Sub
任务队列、失败重试	MessageQueue + Ack
与远程进程	确认 传输层 是否需配合 远程调用 或 网络

---

六、注意

• 消息大小、阻塞、线程安全 以详情页为准。
• 持久化队列 是否落盘见版本说明。