12、API 数据类型、默认值与资源标识全解析

API 数据类型、默认值与资源标识全解析

1. 列表的处理与默认值问题

当列表的潜在大小难以估计，或者有理由认为它可能无边界增长时，依赖实际资源的子集合而非资源上的内联列表是个不错的选择。虽然这可能看起来繁琐，但未来当资源不会因无界列表字段而变得庞大时，API 将更易于管理。若陷入困境，可考虑分页模式。

在某些序列化格式和库中，很难区分列表的零值（ [] ）和空值。与字符串不同，空列表作为值通常是合理的，因此 API 不太可能将空列表值用作指示使用默认值而非空列表的方式。在这种情况下，如何指定希望值为默认值而非字面上的空列表是个复杂的问题。

目前没有简单优雅的答案。要么在创建时使用默认值（假设空列表对新创建的资源无效），要么列表值不是此信息的合适数据类型。若前者不可行，唯一安全的选择是完全跳过列表值，将此数据作为与父资源分开管理的适当子集合进行管理。

2. 映射（Maps）的介绍

映射是非常通用且有趣的数据类型，这里主要考虑两种基于键值对但不同的数据类型：自定义数据类型（资源或接口）和动态键值映射（JSON 中的对象或映射）。二者的主要区别在于是否有预定义的模式。

2.1 自定义数据类型

随着资源需要表示的信息越来越多，通常会将相似的信息分组。例如，对于 ChatRoom 资源的配置信息，可以将与安全和访问相关的字段分组：

interface ChatRoomFlat {
  id: string;
  name: string;
  passw