Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

3.2. MicroProfile Config の設定

3.2.1. ConfigSource 管理リソースでのプロパティーの追加
リンクのコピー

プロパティーは管理リソースとして config-source サブシステムに直接保存できます。

手順

  • ConfigSource を作成し、プロパティーを追加します。 

    /subsystem=microprofile-config-smallrye/config-source=props:add(properties={"name" = "jim"})

3.2.2. ディレクトリーを ConfigSources として設定
リンクのコピー

プロパティーがファイルとしてディレクトリーに保存されている場合、file-name はプロパティーの名前で、ファイルの内容はプロパティーの値になります。

手順

  1. ファイルを保存するディレクトリーを作成します。 

    $ mkdir -p ~/config/prop-files/

  2. ディレクトリーに移動します。 

    $ cd ~/config/prop-files/

  3. プロパティー name の値を保存するファイル name を作成します。 

    $ touch name

  4. プロパティーの値をファイルに追加します。 

    $ echo "jim" > name

  5. ファイル名がプロパティーであり、プロパティーの値が含まれるファイルが含まれる ConfigSource を作成します。 

    /subsystem=microprofile-config-smallrye/config-source=file-props:add(dir={path=~/config/prop-files})

    これにより、以下の XML 設定が以下のようになります。 

    <subsystem xmlns="urn:wildfly:microprofile-config-smallrye:1.0">
    <config-source name="file-props">
        <dir path="/etc/config/prop-files"/>
    </config-source>
</subsystem>

3.2.3. ルートディレクトリーを ConfigSource として設定
リンクのコピー

root 属性を使用して、ディレクトリーを複数の MicroProfile ConfigSource ディレクトリーのルートディレクトリーとして定義できます。

ネストされた root 属性は、/subsystem=microprofile-config-smallrye/config-source=* リソースの dir 複合属性の一部です。これにより、同じルートディレクトリーを共有する場合に、複数の ConfigSource ディレクトリーを指定する必要がなくなります。

ルートディレクトリー内の直接のファイルは無視されます。これらは設定には使用されません。最上位ディレクトリーは ConfigSource として扱われます。ネストされたディレクトリーも無視されます。

注記

最上位ディレクトリーの ConfigSource には、デフォルトで /subsystem=microprofile-config-smallrye/config-source=* リソースの ordinal が割り当てられます。

最上位ディレクトリーに config_ordinal ファイルが含まれている場合は、ファイルで指定された値がデフォルトの ordinal を 上書き します。同じ ordinal を持つ 2 つの最上位ディレクトリーに同じエントリーが含まれている場合、ディレクトリー名はアルファベット順にソートされ、最初のディレクトリーが使用されます。

前提条件

  • MicroProfile Config 拡張機能をインストールし、microprofile-config-smallrye サブシステムを有効にしました。

手順

  1. ターミナルを開きます。

  2. ファイルを保存するディレクトリーを作成します。 

    mkdir -p ~/etc/config/prop-files/

  3. 作成したディレクトリーに移動します。 

    cd ~/etc/config/prop-files/

  4. プロパティー name の値を保存するファイル name を作成します。 

    touch name

  5. プロパティーの値をファイルに追加します。 

    echo "jim" > name

  6. CLI で次のコマンドを実行して、ファイル名がプロパティーであり、ファイルにプロパティーの値が含まれる ConfigSource を作成します。 

    /subsystem=microprofile-config-smallrye/config-source=prop-files:add(dir={path=/etc/config, root=true})

  7. 結果は次の XML 設定になります。 

    <subsystem
xmlns="urn:wildfly:microprofile-config-smallrye:2.0">
 <config-source name="prop-files">
   <dir path="/etc/config" root="true"/>
 </config-source>
</subsystem>

3.2.4. ConfigSource クラスからの ConfigSource の取得
リンクのコピー

カスタムの org.eclipse.microprofile.config.spi.ConfigSource 実装クラスを作成および設定して、設定値のソースを提供することができます。

手順

  • 以下の管理 CLI コマンドは、org.example という名前の JBoss モジュールによって提供される、org.example.MyConfigSource という名前の実装クラスの ConfigSource を作成します。

    org.example モジュールから ConfigSource を使用する場合は、<module name="org.eclipse.microprofile.config.api"/> 依存関係を path/to/org/example/main/module.xml ファイルに追加します。 

    /subsystem=microprofile-config-smallrye/config-source=my-config-source:add(class={name=org.example.MyConfigSource, module=org.example})

    このコマンドを実行すると、microprofile-config-smallrye サブシステムに以下の XML 設定が指定されます。 

    <subsystem xmlns="urn:wildfly:microprofile-config-smallrye:1.0">
    <config-source name="my-config-source">
        <class name="org.example.MyConfigSource" module="org.example"/>
    </config-source>
</subsystem>

カスタムの org.eclipse.microprofile.config.spi.ConfigSource 実装クラスによって提供されるプロパティーはすべての JBoss EAP デプロイメントで使用できます。

3.2.5. ConfigSourceProvider クラスからの ConfigSource 設定の取得
リンクのコピー

複数の ConfigSource インスタンスの実装を登録する、カスタムの org.eclipse.microprofile.config.spi.ConfigSourceProvider 実装クラスを作成および設定できます。

手順

  • config-source-provider を作成します。 

    /subsystem=microprofile-config-smallrye/config-source-provider=my-config-source-provider:add(class={name=org.example.MyConfigSourceProvider, module=org.example})

    このコマンドは、org.example という名前の JBoss Module によって提供される、org.example.MyConfigSourceProvider という名前の実装クラスの config-source-provider を作成します。

    org.example モジュールから config-source-provider を使用する場合は、<module name="org.eclipse.microprofile.config.api"/> 依存関係を path/to/org/example/main/module.xml ファイルに追加します。

    このコマンドを実行すると、microprofile-config-smallrye サブシステムに以下の XML 設定が指定されます。 

    <subsystem xmlns="urn:wildfly:microprofile-config-smallrye:1.0">
    <config-source-provider name="my-config-source-provider">
         <class name="org.example.MyConfigSourceProvider" module="org.example"/>
    </config-source-provider>
</subsystem>

ConfigSourceProvider 実装によって提供されるプロパティーはすべての JBoss EAP デプロイメントで使用できます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る