1.2. 添加 YAML 配置支持
红帽构建的 Quarkus 通过 Eclipse MicroProfile Config 的 SmallRye Config 实现支持 YAML 配置文件。您可以添加 Quarkus Config YAML 扩展,并在属性文件中使用 YAML 配置文件进行配置。Quarkus 支持使用 application.yml 和 application.yaml 作为 YAML 文件的名称。
YAML 配置文件优先于 application.properties 文件。要避免错误,您可以删除 application.properties 文件,并仅使用一种配置文件。
流程
使用以下方法之一在项目中添加 YAML 扩展:
打开
pom.xml文件,将quarkus-config-yaml扩展添加为依赖项:pom.xml文件示例<dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-config-yaml</artifactId> </dependency><dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-config-yaml</artifactId> </dependency>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要从命令行添加
quarkus-config-yaml扩展,请在项目目录中输入以下命令:添加
quarkus-config-yaml扩展./mvnw quarkus:add-extension -Dextensions="quarkus-config-yaml"
./mvnw quarkus:add-extension -Dextensions="quarkus-config-yaml"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.2.1. 将嵌套对象配置与 YAML 搭配使用 复制链接链接已复制到粘贴板!
您可以在已经存在的类中定义嵌套类。此流程演示了如何通过使用 YAML 格式的配置文件来为 Quarkus 应用程序设置嵌套配置属性。
先决条件
- 您有一个 Quarkus Maven 项目。
- 您有一个 PostgreSQL 数据源。
在项目的
pom.xml文件中有以下扩展作为依赖项:-
quarkus-rest-client -
quarkus-jdbc-postgresql -
quarkus-config-yaml
-
流程
-
打开
src/main/resources/application.yaml配置文件。 在
application.yaml文件中添加嵌套类配置属性,如下例所示:application.yaml文件示例Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在使用
application.properties文件中的注释类似,您可以使用注释以 YAML 格式描述您的配置属性。注意始终使用空格来缩进 YAML 配置文件中的属性。YAML 不允许将标签页用于缩进。
1.2.2. 使用 YAML 设置自定义配置配置集 复制链接链接已复制到粘贴板!
使用 Quarkus,您可以设置特定于应用程序不同配置配置集的配置属性和值。您可以使用特定的配置文件启动应用程序,以访问特定的配置。此流程演示了如何以 YAML 格式为特定配置集提供配置。
先决条件
- 您有一个 Quarkus Maven 项目,它配置为使用带有 JDBC 数据源驱动程序的 PostgreSQL 数据源
-
您有
quarkus-jdbc-postgresql和quarkus-config-yaml扩展作为项目的pom.xml文件中的依赖项
流程
-
打开
src/main/resources/application.yaml配置文件。 要设置配置集依赖配置,请在使用
"%<profile_name>" 语法定义键值对前添加配置集名称。确保将配置集名称放在引号中。提示在 YAML 中,所有以特殊字符开头的字符串都必须放在引号内。
在以下示例中,当您以开发模式启动 Quarkus 应用程序时,PostgreSQL 数据库被配置为位于
jdbc:postgresql://localhost:5432/some-databaseURL:src/main/resources/application.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow