このセクションの内容

設定

Jtest  は、.properties ファイルに指定された設定によってカスタマイズできます (「設定リファレンス」を参照)。基本的な設定は、[INSTALL_DIR] にある  jtestcli.properties  ファイルに記載されています。 利便性のため、$USER_HOME  ディレクトリに共通設定ファイル jtestcli.properties を格納して、 [INSTALL_DIR] ディレクトリに格納されたプロパティ ファイルの設定を上書きすることもできます。カスタム . properties ファイルを作成し、 -settings スイッチを使用してjtestcli に渡すこともできます。 カスタム .properties ファイルを指定する場合は、絶対パスを使用します。

-settings スイッチは複数回使用して複数の .properties ファイルを指定できます。同じキーのエントリは上書きされます。

jtestcli -settings path/to/settings.properties  -settings path/to/another/settings.properties

設定の階層

全般的な設定は次の順序で適用されます。

1. [INSTALL_DIR]/etc/jtestcli.properties: 基本構成であり、変更してはいけません。

2. [INSTALL_DIR]/jtestcli.properties: 共通に使用される設定 (ライセンス、レポートなど) のテンプレートを含むメインの設定ファイルです。

3. [USER_HOME]/jtestcli.properties: 利便性のために、設定ファイルをホーム ディレクトリに配置して [INSTALL_DIR] の設定を上書きすることができます (たとえば、設定が再インストールやアップデートの影響を受けないようにするため)。

4. [WORKING_DIR]/jtestcli.properties: 利便性のため、作業ディレクトリに設定ファイルを保存できます。

5. コマンドライン スイッチ -settings path/to/settings.properties (-settings ../settings.properties) で渡されたカスタム設定

   6. コマンドライン スイッチ -property [key=value]で渡されたカスタム設定

上記のすべての設定は、コマンドライン スイッチ (例:  -report, -config) から渡されるカスタム設定で上書きすることができます。

Ant および Maven のパターン

Ant または Maven に設定ファイルへのパスを渡すには、次のパターンを使用します。

<settings>path/to/settings.properties</settings>

Maven の設定階層

Maven を使用している場合、以下によって jtestcli の設定を行うことができます。

• -Djtest.[Maven property name] (例: -Djtest.settings="my.general.properties")
• pom.xml ファイル
• -Dproperty.jtest.[property name] (例: -Dproperty.jtest.license.use_network=true)

-Djtest と pom.xml は、どちらも -Dproperty.jtest で渡された設定を上書きします。

-Djtest は、pom.xml の設定がユーザー プロパティとして提供されている場合、pom.xml の設定を上書きします。しかし、設定の値が直接 pom.xml で指定されている場合は、この値が最優先され、コマンドラインで上書きすることはできません。たとえば、ユーザー プロパティ <config>${jtest.config}</config> として指定されたテスト コンフィギュレーションは、
-Djtest.config で上書きできます。しかし、<config>builtin://Demo Configuration</config> としてハードコーディングされている場合は上書きできません。

パラメーターの全リストについては、「Maven 用 Jtest ゴール リファレンス」ページを参照してください。

カスタム設定、ライセンス、ルール、テスト コンフィギュレーション、コンパイラ コンフィギュレーションなど、ユーザー レベルでカスタマイズしたすべてのものは、再インストールや更新などの影響を受けないよう、Jtest のインストール ディレクトリの外に保存するべきです。

現在の設定の参照 

各設定の元の値を含めた現在の設定およびカスタマイズの状況を参照するには、-showsettings スイッチを使用します。 

Ant および Maven のパターン

Ant または Maven を使用する場合、次のパターンを使用して現在の設定を参照できます。

<showsettings>true</showsettings>

JVM、フレームワーク、およびアプリケーションの設定

次の表は、Jtest のその他の設定ファイルの説明です。