このセクションは、Ant 用 Jtest タスクおよびパラメーターの情報を提供します。以下のタスクがあります。
jtest
Jtest を実行するタスクです。
パラメーター(ネストされた要素)
名前 | 設定可能な値 / データ型 | 説明 | 必須 |
---|---|---|---|
compilation | Compilation | 手動コンパイル データの記述です (詳細については「コンパイル データの手動カスタマイズ」ページを参照してください)。 | いいえ |
compilations | List | 動コンパイル データの記述のリストです(詳細については「コンパイル データの手動カスタマイズ」ページを参照してください)。 | いいえ |
config | String | ||
dataUpdate | String | ビルドから収集されたコンパイル データを手動で更新できます。 ユーザー プロパティ: | いいえ |
exclude | String | 選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名または複数のファイル名に一致する Ant glob パターンを指定できます。 ユーザー プロパティ: | いいえ |
excludes | List | exclude パラメーターのリストです。 ユーザー プロパティ: | いいえ |
excludeTestSources | true | false | テスト ソースを解析対象から除外します。 ユーザー プロパティ: | いいえ |
fail | true | false | 違反がレポートされた場合、ビルドを失敗させます。 ユーザー プロパティ: | いいえ |
home | Path | Jtest のインストール ディレクトリです。定義されていない場合、PATH で指定された Jtest の場所を使用します。 ユーザー プロパティ: | 推奨 |
ignoredIds | List | 無視するコンパイル ID のリストです。 ユーザー プロパティ: | いいえ |
include | String | 選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。 ユーザー プロパティ: | いいえ |
includes | List | ユーザー プロパティ: | いいえ |
publish | true | false | ローカル解析の結果を DTP サーバーにパブリッシュするかどうかを指定します。 ユーザー プロパティ: | いいえ |
report | Path | 生成されたレポートが保存される場所です。 ユーザー プロパティ: | いいえ |
resource | String | 解析対象ファイルの範囲を指定するのに使用されるパターンです。リソースが指定されていない場合、ビルドされたすべてのプロジェクトが解析されます。 ユーザー プロパティ: | いいえ |
resources | List | resource パラメーターのリストです。 ユーザー プロパティ: | いいえ |
settings | Path | カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。 ユーザー プロパティ: jtest.settings | いいえ |
settingsList | Listq | settings パラメーターのリストです。 ユーザー プロパティ: | いいえ |
showDetails | true | false | より詳細な進捗情報を表示します。 ユーザー プロパティ: | いいえ |
showSettings | true | false | 現在の設定およびカスタマイズの状況を出力します。各構成エントリがどこで指定されているか (.properties ファイルなど) を表示します。 ユーザー プロパティ: | いいえ |
skip | true |false | Jtest の実行のスキップを有効または無効にします。true を設定した場合、jtest.data.json データ ファイルだけが生成されます。 ユーザー プロパティ: | いいえ |
tempDir | Path | タスクが一時リソース (データ ファイルのディレクトリ、キャッシュなど) を格納する場所を指定します。レポートの場所ではありません。 | いいえ |
パラメーターの詳細
config
テスト コンフィギュレーション名です。次のタイプがサポートされています。
- ビルトイン テスト コンフィギュレーション 例: "
builtin://Recommended Rules"
- DTP テスト コンフィギュレーション 例:
"dtp://New Config"
- ユーザー定義テスト コンフィギュレーション 例:
"user://Your Config"
ユーザー定義コンフィギュレーションは [INSTALL_DIR]/configs/user ディレクトリに *.properties ファイルとして格納する必要があります。
dataUpdate
ビルドから収集されたコンパイル データを手動で更新できます。
- サポートされるアクション: prepend、append、set
- サポートされるデータ型: classpath、bootpath、sourcepath、binarypath、sourcecode (set のみ)、encoding (set のみ)
- スコープ: 収集されたすべてのプロジェクト データが更新されます。
コンパイル データ モデルの詳細については「コンパイル データの手動カスタマイズ」および「コンパイル データ モデル」を参照してください。
exclude
選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。
例 1: /com/parasoft/**
というパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します。
例 2: /com/parasoft/jtest/*
というパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません。
例 3: path:/home/user/project/src/test/java/**
というパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します。
include
選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。
例 1: /com/parasoft/**
というパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを解析対象に含めます。
例 2: /com/parasoft/jtest/*
というパターンは、com.parasoft.jtest パッケージのすべてのファイルを解析対象に含めますが、サブパッケージのファイルは含めません。
例 3: path:/home/user/project/src/test/java/**
というパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを解析対象に含めます。
resource
解析の入力スコープです。リソースが指定されていない場合、ビルドされたすべてのプロジェクトが解析されます。
次のパターンを使用してパスを指定します: "${ProjectName}/my/src/dir/my/package/file.java"
以下のワイルドカードを使用できます。
- '?' は、1 文字に一致します。
- '*' は (パスの区切り文字 '/' を除く) 0 個以上の文字に一致します 。
- ワイルドカード '**' は、パス区切り文字 '/' を含むパス全体に一致します。
settings
カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。
agent
パラメーター
名前 | 設定可能な値 / データ型 | 説明 | 必須 |
---|---|---|---|
task | JUnit | Java | カバレッジを収集するタスクです。skip に true を設定した場合、このタスクは、Jtest エージェントを使用せずに実行されます。 | いいえ |
property | String | -javaagent に追加のパラメーターを設定できます。 ユーザー プロパティ: | いいえ |
home | Path | Jtest のインストール ディレクトリです。 ユーザー プロパティ: | はい |
skip | true | false | Jtest の実行のスキップを有効または無効にします。true を設定した場合、jtest.data.json データ ファイルだけが生成されます。 ユーザー プロパティ: | いいえ |
runtimeDataLocation | Path | カバレッジ実行データが保存されるファイルのパスです。 ユーザー プロパティ: | いいえ |
metadataLocation | Path | カバレッジ メタデータが保存されるファイルのパスです。 ユーザー プロパティ: | いいえ |
coverage | カバレッジの収集の設定を行うパラメーターのセットです。
| いいえ |
パラメーターの詳細
coverage
デフォルト値:
<jtest> <coverage> <skip>false</skip> <includes> <include>**</include> </includes> <excludes>< excludes> <testIncludes> <testInclude>**/*Test.class</testInclude> </testIncludes> <testExcludes><testExcludes> </coverage> </jtest>
metadataLocation
デフォルト値: ${basedir}/parasoft/jtest-instrument/metadata.data
property
利用可能なオプションの一覧は「カバレッジ エージェントの構成」を参照してください。 -javaagent
への引数として指定されたプロパティは、agent.properties ファイルで設定されたプロパティを上書きします。
runtimeDataLocation
デフォルト値:${basedir}/parasoft/jtest-instrument/runtimedata.data
monitor
ビルドをスキャンして Jtest Java エージェントの設定を生成し、monitorLocation パラメーターで指定された場所にモニター パッケージを作成します。
モニターパッケージには、以下が含まれます。
- static_coverage.xml - 静的カバレッジ データを格納したファイル
- agent.jar - Jtest Java カバレッジ エージェントの jar アーカイブ
- agent.properties - ビルド処理中に生成されたスコープ パラメーターおよびその他の属性を含むエージェント設定ファイル
- agent.sh/agent.bat - アプリケーションのモニタリングに必要な Jtest Java エージェント VM 引数を生成するスクリプト
属性
名前 | 設定可能な値 / データ型 | 説明 | 必須 |
---|---|---|---|
agentServerEnabled | true | false | Agent サーバーの有効化スイッチです。 デフォルト値: true ユーザー プロパティ: jtest.agentServerEnabled | いいえ |
autostartAgent | true | false | カバレッジ収集の自動開始の有効化スイッチです。 デフォルト値: true ユーザー プロパティ: jtest.autostartAgent | いいえ |
compilation | Configuration | 手動コンパイル データの記述です (詳細については「コンパイル データの手動カスタマイズ」ページを参照してください)。 | いいえ |
coverage | カバレッジの収集の設定を行うパラメーターのセットです。
| いいえ | |
exclude | String | 選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。または複数のファイル名に一致する Ant glob パターンを使用できます。 ユーザー プロパティ: | いいえ |
excludes | exclude パラメーターのリストです。 ユーザー プロパティ: | いいえ | |
home | Path | Jtest のインストール ディレクトリです。定義されていない場合、PATH で指定された Jtest の場所を使用します。 ユーザー プロパティ: | 推奨 |
ignoredIds | List | 無視するコンパイル ID のリストです。 ユーザー プロパティ: | いいえ |
include | String | 選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。 ユーザー プロパティ: | いいえ |
includes | include パラメーターのリストです。 ユーザー プロパティ: | いいえ | |
monitorLocation | Path | モニター パッケージが作成される場所へのパスです。 デフォルト値: ${project.build.directory}/jtest/monitor/monitor.zip ユーザー プロパティ: jtest.monitorLocation | いいえ |
publish | true | false | 結果を DTP サーバーにパブリッシュするかどうかを指定します。 ユーザー プロパティ: | いいえ |
report | Path | 生成されたレポートが保存される場所です。 ユーザー プロパティ: | いいえ |
resource | String | 解析対象ファイルの範囲を指定するのに使用されるパターンです。リソースが指定されていない場合、ビルドされたすべてのプロジェクトが解析されます。 ユーザー プロパティ: | いいえ |
resources | List | resource パラメーターのリストです。 ユーザー プロパティ: | いいえ |
settings | Path | カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。 ユーザー プロパティ: | いいえ |
settingsList | List | settings パラメーターのリストです。 ユーザー プロパティ: | いいえ |
showDetails | true | false | より詳細な進捗情報を表示します。 ユーザー プロパティ: | |
showSettings | true | false | 現在の設定およびカスタマイズの状況を出力します。各構成エントリがどこで指定されているか (jtest..properties ファイルなど) を表示します。 ユーザー プロパティ: | いいえ |
skip | true | false | Jtest の実行のスキップを有効または無効にします。 ユーザー プロパティ: | いいえ |
パラメーターの詳細
exclude
選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。
例 1: /com/parasoft/**
というパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します。
例 2: /com/parasoft/jtest/*
というパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません。
例 3: path:/home/user/project/src/test/java/**
というパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します。
include
選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。
例 1: /com/parasoft/**
というパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを解析対象に含めます。
例 2: /com/parasoft/jtest/*
というパターンは、com.parasoft.jtest パッケージのすべてのファイルを解析対象に含めますが、サブパッケージのファイルは含めません。
例 3: path:/home/user/project/src/test/java/**
というパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを解析対象に含めます。
resource
解析の入力スコープです。リソースが指定されていない場合、ビルドされたすべてのプロジェクトが解析されます。
次のパターンを使用してパスを指定します: "${ProjectName}/my/src/dir/my/package/file.java"
以下のワイルドカードを使用できます。
- '?' は、1 文字に一致します。
- '*' は (パスの区切り文字 '/' を除く) 0 個以上の文字に一致します 。
- ワイルドカード '**' は、パス区切り文字 '/' を含むパス全体に一致します。
settings
カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。
設定名がビルド システム プラグイン用の設定と一致していない可能性があります。詳細については「設定リファレンス」を参照してください。
instrument (非推奨)
Jtest テストのインストゥルメンテーション タスクです。
パラメーター (ネストされた要素)
名前 | 設定可能な値 / データ型 | 説明 | 必須 |
---|---|---|---|
fileset | Fileset | インストゥルメントの対象となるテストの .class ファイルを指定します。 | いいえ |
home | Path | Jtest のインストール ディレクトリです。 ユーザー プロパティ: | はい |
skip | true | false | instrument タスクの実行をスキップするかどうかを指定します。 ユーザー プロパティ: デフォルト値: false | いいえ |
tempDir | Path | 一時リソース (データ ファイルやキャッシュなど) を格納する場所を指定します。 ユーザー プロパティ: デフォルト値: parasoft | いいえ |
classpathRefId | インストゥルメンテーション タスクによって生成された Path オブジェクトの参照 ID です。 ユーザー プロパティ: デフォルト値: jtest.classpath | いいえ | |
destDir | Path | インストゥルメントされたクラスが保存されるディレクトリへのパスです。指定されていない場合、インストゥルメント中に元のテスト クラスが上書きされます。 ユーザー プロパティ: デフォルト値: 指定されたファイルセットのディレクトリです。 | いいえ |
runtimeDataLocation | Path | カバレッジ実行データが保存されるファイルのパスです。 ユーザー プロパティ: | いいえ |
metadataLocation | Path | カバレッジ実行データメタデータが保存されるファイルのパスです。 ユーザー プロパティ: | いいえ |
パラメーターの詳細
classpathRefId
インストゥルメンテーション タスクによって生成された Path オブジェクトの参照 ID です。使用するには、<junit> タスクの <classpath> タグの内側に<path refid="jtest.classpath"/> を追加します。パラメーター内で参照されたクラス パスにインストゥルメントされたバイトコードおよびカバレッジの収集に必要なリソースが置かれるため、ファイルセットの本来のバイトコードが <junit> タスクの classpath 上にあってはいけません。既存のクラスパスが同じ ID を持つ場合、クラスパスが拡張されます。skip が指定されている場合、指定されたファイルセットのクラスだけを参照します。
instrument-test (非推奨)
Jtest テストのインストゥルメンテーション タスクです。
パラメーター (ネストされた要素)
名前 | 設定可能な値 / データ型 | 説明 | 必須 |
---|---|---|---|
fileset | Fileset | インストゥルメントの対象となるアプリケーションの .class ファイルを指定します。 | いいえ |
home | Path | Jtest のインストール ディレクトリです。 ユーザー プロパティ: | いいえ |
skip | true | false | インストゥルメント タスクの実行をスキップするかどうかを指定します。 ユーザー プロパティ: デフォルト値: false | いいえ |
tempDir | Path | 一時リソース (データ ファイルやキャッシュなど) を格納する場所を指定します。 ユーザー プロパティ: デフォルト値: parasoft | いいえ |
classpathRefId | インストゥルメンテーション タスクによって生成された Path オブジェクトの参照 ID です。 ユーザー プロパティ: デフォルト値: jtest.classpath | いいえ | |
destDir | Path | インストゥルメントされたクラスが保存されるディレクトリへのパスです。指定されていない場合、インストゥルメント中に元のテスト クラスが上書きされます。 ユーザー プロパティ: デフォルト値: 指定されたファイルセットのディレクトリです。 | いいえ |
runtimeDataLocation | Path | カバレッジ実行データが保存されるファイルのパスです。 ユーザー プロパティ: | いいえ |
パラメーターの詳細
classpathRefId
インストゥルメンテーション タスクによって生成された Path オブジェクトの参照 ID です。使用するには、<junit> タスクの <classpath> タグの内側に<path refid="jtest.classpath"/> を追加します。パラメーター内で参照されたクラス パスにインストゥルメントされたバイトコードおよびカバレッジの収集に必要なリソースが置かれるため、ファイルセットの本来のバイトコードが <junit> タスクの classpath 上にあってはいけません。既存のクラスパスが同じ ID を持つ場合、クラスパスが拡張されます。skip が指定されている場合、指定されたファイルセットのクラスだけを参照します。