提供替代格式

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 源的忠实表示。它是从一组扁平的属性源列表构建的，并且必须对键的形式做出假设。