第4章 Quarkus アプリケーションへの設定値の注入

手順

1. GreetingResource.java ファイルを確認し、次のインポートステートメントが含まれていることを確認します。

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

   import java.util.Optional;
   import javax.inject.Inject;

2. src/main/java/org/acme/config ディレクトリーに GreetingConfiguration.java ファイルを作成します。

3. ConfigProperties と Optional のインポートを GreetingConfiguration.java ファイルに追加します。

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

   import io.quarkus.arc.config.ConfigProperties;
   import java.util.Optional;
   import javax.inject.Inject;

4. GreetingConfiguration.java ファイルに greeting プロパティーの GreetingConfiguration クラスを作成します。

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

   @ConfigProperties(prefix = "greeting") 

   1

   
   public class GreetingConfiguration {
   
       private String message;
       private String suffix = "!"; 

   2

   
       private Optional<String> name;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   
       public String getSuffix() {
           return suffix;
       }
   
       public void setSuffix(String suffix) {
           this.suffix = suffix;
       }
   
       public Optional<String> getName() {
           return name;
       }
   
       public void setName(Optional<String> name) {
           this.name = name;
       }
   }

   1

   prefix はオプションです。接頭辞を指定しない場合は、クラスの名前で決定されます。この例では、接頭辞は greeting です。

   2

   greeting.suffix が設定されていない場合、! はデフォルト値です。

5. @Inject アノテーションを使用して GreetingConfiguration クラスを GreetingResource クラスに注入します。

   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.getMessage() + " " + config.getName().orElse("world") + config.getSuffix();
       }
   }

6. 開発モードでアプリケーションをコンパイルして起動します。

   ./mvnw quarkus:dev

   重要

   クラスプロパティーの値を指定しないと、アプリケーションはコンパイルに失敗し、値が指定されていないことを示す javax.enterprise.inject.spi.DeploymentException を受け取ります。これは、Optional フィールドおよびデフォルト値のフィールドには適用されません。

7. エンドポイントがメッセージを返すことを確認するには、新しいターミナルウィンドウに以下のコマンドを入力します。

   curl http://localhost:8080/greeting

8. 以下のメッセージが表示されます。

   hello quarkus!

9. アプリケーションを停止するには、CTRL+C を押します。