标签: YAML

当设计一个Spring Boot应用程序时，我们通常希望使用外部配置来定义我们的应用程序属性。这让我们可以使用相同的代码跨不同环境。在某些情况下，我们可能希望即使对于同一个环境，也将属性定义在多个YAML配置文件中。

在本教程中，我们将学习在创建Spring Boot应用程序时加载多个YAML配置文件的两种方法。

2.1. YAML设置

我们的第一个文件列出了学生名单。我们将把它命名为_application-students.yml_并将其放置在_./src/main/resources_目录中：

Kahen大约 3 分钟

YAML（YAML Ain’t Markup Language）是一种人类可读的数据序列化格式，通常用于配置文件。官方的Kotlin库kotlinx-serialization并不直接支持YAML格式。然而，有一些社区支持的库，比如kaml和YamlKt，它们内部使用kotlinx-serialization来支持YAML格式。

在本文中，我们将学习在Kotlin中读取YAML内容的反序列化过程。

2. 依赖设置

首先，让我们在项目的pom.xml中添加kaml-jvm依赖：

Kahen大约 7 分钟

Swagger：指定同一响应代码的两个响应

在本文中，我们将编写一个允许为同一响应代码返回两个不同对象的API规范。我们将演示如何使用该规范生成Java代码和Swagger文档。

2. 问题介绍

让我们定义两个对象。一辆汽车（Car）具有所有者和车牌作为属性，两者都是字符串类型。另一方面，自行车（Bike）具有所有者和速度。速度是一个整数。

使用OpenAPI，这些定义对应于以下描述：

Car:
  type: object
  properties:
    owner:
      type: string
    plate:
      type: string
Bike:
  type: object
  properties:
    owner:
      type: string
    speed:
      type: integer

Kahen大约 5 分钟

OpenAPI文档中的文本描述格式化 | Baeldung

1. 引言

OpenAPI规范（前Swagger规范）标准化了REST API文档语言，并且是平台无关的。我们可以以YAML或JSON格式创建OpenAPI文档。

另一方面，Swagger是一系列用于实现和使用该标准的工具集合。有些是免费的，有些是开源的，有些是商业的。这些工具帮助我们设计、文档化和使用REST API。

在本文中，我们将学习如何格式化OpenAPI文档中的文本描述。

2. OpenAPI编辑器

有几种工具支持我们创建OpenAPI文档。一些流行的工具包括：

Kahen大约 5 分钟