提供替代格式

DeepSeek V3 中英对照 Serving Alternative Formats

环境端点默认的JSON格式非常适合Spring应用程序使用，因为它能直接映射到Environment抽象。如果你愿意，也可以通过为资源路径添加后缀（".yml"、".yaml"或".properties"）来获取相同数据的YAML或Java属性格式。这对于那些不关心JSON端点结构或其提供的额外元数据的应用程序非常有用（例如，非Spring应用程序可能会受益于这种方法的简洁性）。

YAML和properties表示形式有一个额外的标志（作为名为resolvePlaceholders的布尔查询参数提供），用于指示在可能的情况下，应在渲染前解析源文档中的占位符（采用标准的Spring ${…​} 格式）。这对于不了解Spring占位符约定的使用者来说是一个有用的功能。

备注

使用 YAML 或 properties 格式存在一些限制，主要与元数据的丢失有关。例如，JSON 被结构化为一个有序的属性源列表，其名称与源相关联。而 YAML 和 properties 形式则被合并为一个单一的映射，即使值的来源有多个，原始源文件的名称也会丢失。此外，YAML 表示也不一定是后端存储库中 YAML 源的忠实表示。它是由一个扁平的属性源列表构建的，并且必须对键的形式做出假设。