1.8. プロパティー式

設定プロパティーの値の置き換え:

プロパティー式を使用して、設定内のプロパティー値のハードコーディングを回避できます。以下の例のように、${<property_name>} 構文を使用して、設定プロパティーを参照する式を作成します。

remote.host=quarkus.io
callable.url=https://${remote.host}/

remote.host=quarkus.io
callable.url=https://${remote.host}/

callable.url プロパティーの値は https://quarkus.io/ に解決されます。

特定の設定プロファイルに固有のプロパティー値の設定:

以下の例では、%dev 設定プロファイルとデフォルトの設定プロファイルは、異なるホストアドレスでデータソース接続 URL を使用するように設定されます。

%dev.quarkus.datasource.jdbc.url=jdbc:mysql://localhost:3306/mydatabase?useSSL=false
quarkus.datasource.jdbc.url=jdbc:mysql://remotehost:3306/mydatabase?useSSL=false

%dev.quarkus.datasource.jdbc.url=jdbc:mysql://localhost:3306/mydatabase?useSSL=false
quarkus.datasource.jdbc.url=jdbc:mysql://remotehost:3306/mydatabase?useSSL=false

データソースドライバーは、アプリケーションの起動に使用する設定プロファイルに応じて、プロファイルに設定したデータベース URL を使用します。

カスタム application.server プロパティーに対して、設定プロファイルごとに異なる値を設定することで、簡単に同じ結果を得ることができます。その後、次の例に示すように、アプリケーションのデータベース接続 URL でプロパティーを参照できます。

%dev.application.server=localhost
application.server=remotehost

quarkus.datasource.jdbc.url=jdbc:mysql://${application.server}:3306/mydatabase?useSSL=false

%dev.application.server=localhost
application.server=remotehost

quarkus.datasource.jdbc.url=jdbc:mysql://${application.server}:3306/mydatabase?useSSL=false

application.server プロパティーは、アプリケーションの実行時に選択するプロファイルに応じて適切な値に解決されます。

プロパティー式のデフォルト値の設定:

プロパティー式のデフォルト値を定義できます。Quarkus は、式を展開するために必要なプロパティーの値が設定ソースのいずれからも解決されない場合に、デフォルト値を使用します。次の構文を使用して、式のデフォルト値を設定できます。

${<property_name>:<default_value>}

${<property_name>:<default_value>}

以下の例では、データソース URL のプロパティー式は、application.server プロパティーのデフォルト値として mysql.db.server を使用します。

quarkus.datasource.jdbc.url=jdbc:mysql://${application.server:mysql.db.server}:3306/mydatabase?useSSL=false

quarkus.datasource.jdbc.url=jdbc:mysql://${application.server:mysql.db.server}:3306/mydatabase?useSSL=false

プロパティー式のネスト化:

プロパティー式を別のプロパティー式内にネスト化することで、プロパティー式を作成できます。ネスト化されたプロパティー式を展開する際には、内部の式が最初に展開されます。プロパティー式をネストするには、次の構文を使用します。

${<outer_property_name>${<inner_property_name>}}

${<outer_property_name>${<inner_property_name>}}

複数のプロパティー式を組み合わせます。

次の構文を使用して、2 つ以上のプロパティー式を結合できます。

${<first_property_name>}${<second_property_name>}

${<first_property_name>}${<second_property_name>}

プロパティー式と環境変数の組み合わせ:

プロパティー式を使用して、環境変数の値を置き換えることができます。次に示す例の式は、HOST 環境変数に設定される値を application.host プロパティーの値として置き換えます。

remote.host=quarkus.io
application.host=${HOST:${remote.host}}

remote.host=quarkus.io
application.host=${HOST:${remote.host}}