使用 Gradle Ext 属性注入 Quarkus 配置

本文介绍如何通过 Gradle Ext 属性将构建时间和项目版本等信息注入到 Quarkus 项目中，解决配置注入失败的问题，并提供有效的解决方案和代码示例，帮助开发者更好地管理和配置 Quarkus 应用。

在 Quarkus 项目中，我们经常需要将构建时的信息，例如项目版本和构建时间，注入到应用程序中。这可以通过 Gradle 的 Ext 属性来实现。然而，在实践中，可能会遇到配置注入失败的问题。本文将介绍如何正确地将 Gradle Ext 属性注入到 Quarkus 配置中，并提供一个有效的解决方案。

问题描述

假设我们想要将项目版本和构建时间注入到 Quarkus 项目中。在 build.gradle 文件中，我们定义了以下 Ext 属性：

version '0.0.0-SNAPSHOT'

ext {
   buildTime = new java.text.SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ").format(new Date())
}

然后在 Java 源代码中，我们尝试使用 @ConfigProperty 注解注入这些属性：

import org.eclipse.microprofile.config.inject.ConfigProperty;

import javax.inject.Inject;

public class MyService {

   @Inject
   @ConfigProperty(name = "version")
   String version;

   @Inject
   @ConfigProperty(name="buildTime")
   String buildTime;

   public String getVersion() {
       return version;
   }

   public String getBuildTime() {
       return buildTime;
   }
}

虽然 version 属性可以成功注入，但 buildTime 属性却失败，并抛出 ConfigurationException 异常。

解决方案

问题的关键在于，Quarkus 在启动时可能无法立即获取到 Gradle Ext 属性的值。为了解决这个问题，我们可以为 @ConfigProperty 注解提供一个默认值。

修改后的 Java 源代码如下：

import org.eclipse.microprofile.config.inject.ConfigProperty;

import javax.inject.Inject;

public class MyService {

   @Inject
   @ConfigProperty(name = "version")
   String version;

   @Inject
   @ConfigProperty(name = "buildTime", defaultValue="defaultValue")
   String buildTime;

   public String getVersion() {
       return version;
   }

   public String getBuildTime() {
       return buildTime;
   }
}

通过为 buildTime 属性设置一个默认值，即使 Quarkus 在启动时无法立即获取到 Gradle Ext 属性的值，也能正常启动应用程序。

进一步优化

虽然上述解决方案可以解决配置注入失败的问题，但我们仍然需要确保最终注入的是 Gradle Ext 属性的值，而不是默认值。为了实现这一点，我们需要在构建过程中将 Gradle Ext 属性的值传递给 Quarkus。

1. 在 build.gradle 中生成配置文件：

   

   琅琅配音

   全能AI配音神器

   208

   查看详情

   我们可以使用 Gradle Task 在构建过程中生成一个 application.properties 文件，并将 Gradle Ext 属性的值写入该文件。

   task generateConfig {
       doLast {
           file("src/main/resources/application.properties").write("buildTime=${ext.buildTime}\nversion=${version}")
       }
   }
   
   quarkusBuild.dependsOn generateConfig

   登录后复制

   这个 Task 会在 src/main/resources 目录下生成一个 application.properties 文件，其中包含 buildTime 和 version 属性的值。

2. 确保 Task 在构建之前执行：

   通过 quarkusBuild.dependsOn generateConfig，我们确保 generateConfig Task 在 quarkusBuild Task 之前执行，从而保证配置文件在构建之前生成。

3. 移除 defaultValue：

   现在，我们可以从 Java 源代码中移除 defaultValue 属性，因为配置文件已经提供了 buildTime 属性的值。

   import org.eclipse.microprofile.config.inject.ConfigProperty;
   
   import javax.inject.Inject;
   
   public class MyService {
   
      @Inject
      @ConfigProperty(name = "version")
      String version;
   
      @Inject
      @ConfigProperty(name="buildTime")
      String buildTime;
   
      public String getVersion() {
          return version;
      }
   
      public String getBuildTime() {
          return buildTime;
      }
   }

   登录后复制

总结

通过以上步骤，我们可以成功地将 Gradle Ext 属性注入到 Quarkus 配置中。首先，我们通过为 @ConfigProperty 注解提供默认值来解决配置注入失败的问题。然后，我们通过在构建过程中生成配置文件，并将 Gradle Ext 属性的值写入该文件，确保最终注入的是 Gradle Ext 属性的值。

注意事项：

• 确保 generateConfig Task 在 quarkusBuild Task 之前执行。
• 根据实际需求调整 buildTime 属性的格式。
• 如果需要注入更多的 Gradle Ext 属性，可以按照上述步骤进行扩展。

通过本文的介绍，希望能够帮助开发者更好地管理和配置 Quarkus 应用，提高开发效率。

以上就是使用 Gradle Ext 属性注入 Quarkus 配置的详细内容，更多请关注php中文网其它相关文章！