使用消息队列 RocketMQ 版提供的 HTTP 协议 SDK 时,需要遵循本文所描述的使用说明。不遵循相关说明可能会影响您的正常使用。

多语言支持

消息队列 RocketMQ 版支持 RESTful 风格的 HTTP 协议通信,并提供了以下 7 种语言的 SDK:

使用需知

  • 确保您需要访问的资源和 HTTP 接入点在同一地域。

    例如您的消息队列 RocketMQ 版实例在华东 1(杭州)地域,则只能使用华东 1(杭州)地域的接入点来访问该地域的实例。您可以实现以下场景的资源访问:

    • 如果您的客户端在华东 1(杭州)地域,为了最佳体验,请使用该实例的 HTTP 内网接入点访问该实例资源。
    • 如果您的客户端在华东 1(杭州)以外的任一地域,请确保客户端可连上互联网,并使用该实例的 HTTP 公网接入点访问该实例资源。
  • TCP 协议的客户端和 HTTP 协议的客户端之间可以实现消息收发。但由于 HTTP 协议采用 XML 序列化,因此消息的属性、内容、Tag、Key 等必须符合 XML 规范。

    如果包含了不符合 XML 规范的相关字符,那么可能出现以下情况:

    • 采用 HTTP 协议发送消息时,发送消息失败。
    • 采用 TCP 协议发送消息,HTTP 协议消费消息时,消费消息失败。

    您可以自行采用 Base64 编码对发送的消息进行编(解)码,以适用于此类不符合 XML 规范的消息收发场景。

HTTP 协议所支持的功能通过不断迭代,与 TCP 协议所支持的功能逐渐对齐。HTTP 协议的迭代版本所支持的功能与 TCP 协议最新版的功能对比说明请参见版本说明