SDT容器

消息 API 支持两种类型的复合容器：

• 映射（Map）
  映射是一个结构化数据容器，其中每个数据字段都与一个键相关联。映射允许应用程序执行基于键的查找。基于键的查找允许直接访问数据，这意味着发布者和接收者不需要就数据的确切格式达成一致。

  映射可以包含映射和流。

  映射支持以下操作：

  • 向具有关联键的字段中添加数据。在 C 和 .NET API 中，数据字段被添加到容器的末尾；因此，添加例程可能无法检测到重复的键。
  • 根据键删除数据字段。
  • 顺序遍历存储在映射中的数据字段。
  • 根据键检索元素。

• 流（Stream）
  流是一个结构化数据容器，它是一系列未键控的数据字段。与映射相比，流的处理速度更快，但流只能从头到尾顺序访问，并且发送者和接收者必须就预定义的数据结构达成一致。流可以包含映射和流。

  流支持以下操作：

  • 向流的末尾添加/追加字段。
  • 顺序遍历存储在流中的字段。

有关可用于设置字段数据、获取字段数据以及遍历或删除字段的操作的可用容器方法和函数的完整列表，请参阅适用于相应消息 API 的 PubSub+ 消息 API。下表列出了相关的接口或函数组。

PubSub+ 消息 API	使用方法
C	- solClient_container 函数
.NET	- ISDTContainer 接口，提供：

• ISDTContainer 方法
• IMapContainer 方法
• IStreamContainer 方法 | | JavaScript 和 Node.js | - solace.SDTMapContainer 方法
• solace.SDTStreamContainer 方法 |

可用的容器方法和函数