4.2. 使用嵌套对象配置

流程

1. 查看 GreetingConfiguration.java 文件，并确保它包括以下导入语句：

   src/main/java/org/acme/config/GreetingConfiguration.java

   import io.quarkus.arc.config.ConfigProperties;
   import java.util.Optional;
   import java.util.List;

   Copy to Clipboard Toggle word wrap

2. 使用 @ConfigProperties 注释在 GreetingConfiguration.java 文件中添加配置。

   以下示例显示了 GreetingConfiguration 类及其属性的配置：

   src/main/java/org/acme/config/GreetingConfiguration.java

   @ConfigProperties(prefix = "greeting")
   public class GreetingConfiguration {
   
       public String message;
       public String suffix = "!";
       public Optional<String> name;
   }

   Copy to Clipboard Toggle word wrap

3. 在 GreetingConfiguration 类中添加一个嵌套类，如下例所示：

   src/main/java/org/acme/config/GreetingConfiguration.java

   @ConfigProperties(prefix = "greeting")
   public class GreetingConfiguration {
   
       public String message;
       public String suffix = "!";
       public Optional<String> name;
       public ContentConfig content;
   
       public static class ContentConfig {
           public Integer prizeAmount;
           public List<String> recipients;
       }
   }

   Copy to Clipboard Toggle word wrap

   本例显示了一个嵌套类 ContentConfig。字段的名称（本例中为 content ）决定了绑定到对象的属性的名称。

4. 在 application.properties 文件中设置 greeting.content.prize-amount 和 greeting.content.recipients 配置属性。

   以下示例显示了 GreetingConfiguration 和 ContentConfig 类的属性值：

   src/main/resources/application.properties

   greeting.message = hello
   greeting.name = quarkus
   greeting.content.prize-amount=10
   greeting.content.recipients=Jane,John

   Copy to Clipboard Toggle word wrap

5. 使用 @Inject 注解将 GreetingConfiguration 类注入 GreetingResource 类，并更新 /greeting 端点返回的消息字符串，显示您为新 greeting.content.prize-amount 和 greeting.content.recipients 属性设置的值：

   src/main/java/org/acme/config/GreetingResource.java

   @Path("/greeting")
   public class GreetingResource {
   
       @Inject
       GreetingConfiguration config;
   
       @GET
       @Produces(MediaType.TEXT_PLAIN)
       public String hello() {
           return config.message + " " + config.name.orElse("world") + config.suffix + "\n" + config.content.recipients + " receive total of candies: " + config.content.prizeAmount;
       }
   }

   Copy to Clipboard Toggle word wrap

6. 以开发模式编译并启动应用程序：

   ./mvnw quarkus:dev

   Copy to Clipboard Toggle word wrap
   重要

   如果没有为类属性提供值，应用程序无法编译，您会收到 javax.enterprise.inject.spi.DeploymentException，它表示缺失的值。这不适用于带有 默认值的 Optional 字段和字段。

7. 在新终端窗口中输入以下命令来验证端点是否返回消息：

   curl http://localhost:8080/greeting

   Copy to Clipboard Toggle word wrap

8. 您会收到一条信息，其中包含第一行上的问候以及第二行上的原概量：

   hello quarkus!
   Jane,John receive total of candies: 10

   Copy to Clipboard Toggle word wrap
9. 按 CTRL+C 停止应用程序。