第4章 Quarkus アプリケーションへの設定値のインジェクション

手順

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

   package org.acme.config;
   
   import java.util.Optional;
   import javax.inject.Inject;

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

3. @ConfigProperties および @Optional の import を GreetingConfiguration.java ファイルに追加します。

   package org.acme.config;
   
   import io.quarkus.arc.config.ConfigProperties;
   import java.util.Optional;

   Copy to Clipboard Toggle word wrap

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

   @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;
       }
   }

   Copy to Clipboard Toggle word wrap

   1

   prefix はオプションです。接頭辞を設定しないと、クラス名により決定されます。この例では、greeting になります。

   2

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

5. コンテキストおよびディペンデンシーインジェクション (CDI) @Inject アノテーションを使用して、属性を GreetingResource クラスにインジェクトします。

   @Inject
   GreetingConfiguration greetingConfiguration;

   Copy to Clipboard Toggle word wrap

6. 開発モードでお使いのアプリケーションをコンパイルするには、プロジェクトディレクトリーから以下のコマンドを入力します。

   ./mvnw quarkus:dev

   Copy to Clipboard Toggle word wrap
   重要

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

手順

1. GreetingConfiguration.java ファイルを確認し、以下の import ステートメントが含まれることを確認します。

   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 クラスおよびそのプロパティーの設定について示しています。

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

   Copy to Clipboard Toggle word wrap

3. 以下に示す例のようなネストされたクラス設定を追加します。

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

   Copy to Clipboard Toggle word wrap

   この例では、ネストされたクラス HiddenConfig を示しています。フィールドの名前 (ここでは hidden) が、オブジェクトにバインドされるプロパティーの名前を決定します。

4. 同等の設定プロパティーを application.properties ファイルに追加します。

   以下の例は、GreetingConfiguration クラスおよび HiddenConfig クラスのプロパティーの値を示しています。

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

   Copy to Clipboard Toggle word wrap

5. 開発モードでお使いのアプリケーションをコンパイルするには、プロジェクトディレクトリーから以下のコマンドを入力します。

   ./mvnw quarkus:dev

   Copy to Clipboard Toggle word wrap

手順

1. GreetingConfiguration.java ファイルを確認し、以下の import ステートメントが含まれることを確認します。

   package org.acme.config;
   
   import io.quarkus.arc.config.ConfigProperties;
   import org.eclipse.microprofile.config.inject.ConfigProperty;
   import java.util.Optional;

   Copy to Clipboard Toggle word wrap

2. GreetingConfiguration クラスをインターフェースとして GreetingConfiguration.java ファイルに追加します。

   @ConfigProperties(prefix = "greeting")
   public interface GreetingConfiguration {
   
       @ConfigProperty(name = "message") 

   1

   
       String message();
   
       @ConfigProperty(defaultValue = "!")
       String getSuffix(); 

   2

   
   
       Optional<String> getName(); 

   3

   
   }

   Copy to Clipboard Toggle word wrap

   1

   設定プロパティーの名前が getter メソッド命名規則に準拠しないため、@ConfigProperty アノテーションを設定する必要があります。

   2

   この例では、name は設定されていなかったので、対応するプロパティーが greeting.suffix になります。

   3

   メソッド名は getter メソッドの命名規則 (対応するプロパティーは greeting.name) に従い、デフォルト値が必要ないため、@ConfigProperty アノテーションを指定する必要はありません。

3. 開発モードでお使いのアプリケーションをコンパイルするには、プロジェクトディレクトリーから以下のコマンドを入力します。

   ./mvnw quarkus:dev

   Copy to Clipboard Toggle word wrap
   重要

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