Jtest を実行する Gradle タスクです。

属性

projectNameTemplate

パラメーターの詳細

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 ファイルへの絶対パスまたは相対パスです。

projectNameTemplate

プロジェクト名のテンプレートです。デフォルトでは、次のパターンを使用して json 中のプロジェクト名が作成されます :"groupId:artifactId "。このパラメーターを指定すると、[groupId]、[artifactId]、[version] および [basedir] オプションを使用してパターンを設定できます。たとえば、プロジェクト名を Eclipse のプロジェクト名と合わせることができます。

パラメーター型の詳細

すべてのサンプルは、Jtest Plugin for Gradle がビルドスクリプトに適切に適用されていることを前提としています。詳細については「Jtest Plugin for Gradle の設定」を参照してください。

Compilation Type

• 属性: Compilation
• ネストされたオブジェクト

jtest {
    home = "path/to/jtest"
    compilation {
        id = "main"
        override = true
    }
}

List 型

• 属性: resources
• ビルド中に収集されたリソースと比較するリソースのパターンのリストを指定します。

jtest {
        home = "path/to/jtest"
        resources = [
                "**.java",
                "myGradleProjectName/src/com/mycompany/models/**/*.properties"
        ]
}

String 型

• 属性: Exclude
• 選択されたリソースのうち、解析対象から除外するファイル、パッケージ、ディレクトリのサブセットを指定します。

jtest {
    home = "path/to/jtest"
    exclude = "com/mycompany/models/**/NotInteresting*.properties"
}

詳細については「コンパイル データ モデル」を参照してください。

Jtest でカバレッジを収集するための Gradle タスクです。

パラメーター

パラメーターの詳細

coverage

デフォルト値:

jtest { 
  /* other parameters  */ 
  coverage { 
    skip = false 
    includes = [ 'package/**' ] 
    excludes = [ ] 
    testIncludes = [ 'package/Test.class' ] 
    testExcludes = [ ] 
  } 
}

runtimeDataLocation

デフォルト値: ${basedir}/parasoft/jtest-instrument/runtimedata.data

metadataLocation

デフォルト値: ${basedir}/parasoft/jtest-instrument/metadata.data

ビルドをスキャンして Jtest Java エージェントの設定を生成し、monitorLocation パラメーターで指定された場所にモニター パッケージを作成します。

モニターパッケージには、以下が含まれます。

• static_coverage.xml - 静的カバレッジ データを格納したファイル
• agent.jar - Jtest Java カバレッジ エージェントの jar アーカイブ
• agent.properties - ビルド処理中に生成されたスコープ パラメーターおよびその他の属性を含むエージェント設定ファイル
• agent.sh/agent.bat - アプリケーションのモニタリングに必要な Jtest Java エージェント VM 引数を生成するスクリプト

パラメーター

パラメーターの詳細

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 ファイルへの絶対パスまたは相対パスです。

projectNameTemplate

プロジェクト名のテンプレートです。デフォルトでは、次のパターンを使用して json 中のプロジェクト名が作成されます :"groupId:artifactId "。このパラメーターを指定すると、[groupId]、[artifactId]、[version] および [basedir] オプションを使用してパターンを設定できます。たとえば、プロジェクト名を Eclipse のプロジェクト名と合わせることができます。

パラメーター型の詳細

すべてのサンプルは、プラグインがビルドスクリプトに適切に適用されていることを前提としています。詳細については「Configuring the Jtest Plugin for Gradle」を参照してください。

Compilation 型

• 属性: Compilation
• ネストされたオブジェクト

jtest {
    home = "path/to/jtest"
    compilation {
        id = "main"
        override = true
    }
}

List 型

• 属性: resources
• ビルド中に収集されたリソースと比較するリソースのパターンのリストを指定します。

jtest {
        home = "path/to/jtest"
        resources = [
                "**.java",
                "myGradleProjectName/src/com/mycompany/models/**/*.properties"
        ]
}

String Type

• 属性: Exclude
• 選択されたリソースのうち、解析対象から除外するファイル、パッケージ、ディレクトリのサブセットを指定します。

jtest {
    home = "path/to/jtest"
    exclude = "com/mycompany/models/**/NotInteresting*.properties"
}

See コンパイル データ モデル for more information.

Jtest テストのオフライン インストゥルメンテーション タスクです。

パラメーター

パラメーターの詳細

runtimeDataLocation

デフォルト値: ${basedir}/parasoft/jtest-instrument/runtimedata.data

metadataLocation

デフォルト値:${basedir}/parasoft/jtest-instrument/metadata.data

coverage

デフォルト値:

jtest { 
  /* other parameters  */ 
  coverage { 
    skip = false 
    includes = [ 'package/*' ] 
    excludes = [ ] 
    testIncludes = [ 'pacakge/Test.class' ] 
    testExcludes = [ ] 
  } 
}