完全名: com.parasoft.jtest:jtest-maven-plugin:2020.1.0:jtest

このゴールは、Maven のレポートとして使用する必要があります。ビルド データを収集し、指定されたパラメーターを使用して Jtest を実行します (「Jtest Plugin for Maven の設定」を参照)。ビルド セッションの最後に呼び出され、すべてのプロジェクトの集約されたデータを収集します。ゴールはアグリゲータとして機能します。つまり、ゴールの実行はビルド ライフサイクルのフェーズに紐付けされません。

属性

• 実行するには Maven プロジェクトが必要です。
• アグリゲータ プラグインとして実行されます。
• スコープ: compile の成果物の依存関係を解決する必要があります。
• 導入されたバージョン: 1.0.0

パラメーター

パラメーターの詳細

compilation

手動コンパイル データの記述です。詳細については「POM ファイルでのコンパイル データの手動カスタマイズ」ページを参照してください。

• 型: org.codehaus.plexus.configuration.PlexusConfiguration
• 導入されたバージョン: 1.0.4
• 必須: いいえ

compilations

手動コンパイル データの記述のリストです。詳細については「コンパイル データの手動カスタマイズ」を参照してください。

• 型: org.codehaus.plexus.configuration.PlexusConfiguration
• 導入されたバージョン: 1.0.4
• 必須: いいえ

config

テスト コンフィギュレーション名です。次のタイプがサポートされています。

• ビルトイン テスト コンフィギュレーション 例: "builtin://Recommended Rules"
• DTP テスト コンフィギュレーション 例: "dtp://New Config"
• ユーザー定義テスト コンフィギュレーション 例: "user://Your Config"

ユーザー定義コンフィギュレーションは [INSTALL_DIR]/configs/user ディレクトリに *.properties ファイルとして格納する必要があります。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.config

dataUpdate

ビルドから収集されたコンパイル データを手動で更新できます。

• サポートされるアクション: prepend, append, and set.
• サポートされるデータ型: classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode (set のみ)、encoding (set のみ)
• スコープ: 収集されたすべてのプロジェクト データが更新されます。
• 型: java.lang.String
• 導入されたバージョン: 1.2.9
• 必須: いいえ
• ユーザー プロパティ: jtest.dataUpdate

コンパイル データ モデルの詳細については「POM ファイルでのコンパイル データの手動カスタマイズ」を参照してください。

exclude

選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します: path:/home/user/project/src/test/java/**

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.exclude

excludeTestSources

テスト ソースを解析対象から除外します。

• 型: java.lang.String
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• デフォルト値: true
• ユーザー プロパティ: jtest.excludeTestSources

excludes

exclude パラメーターの List です。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.excludes

fail

違反がレポートされた場合、ビルドを失敗させます。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.fail

forceTestReportsImport

Maven 環境で Jtest プラグインが既存のテスト プラグイン (Surefire など) を認識できない場合、デフォルトの場所からテスト結果をインポートします。

• 型: java.lang.Boolean
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.forceTestReportsImport

home

Jtest のインストール ディレクトリです。

• 型: java.io.File
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.home

ignoredIds

無視するコンパイル ID の List です。Maven 3.0.3 以降でサポートされます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.0.4
• 必須: いいえ
• ユーザー プロパティ: jtest.ignoredids

include

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを含めます: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを含めますが、サブパッケージのファイルは含めません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを含めます: path:/home/user/project/src/test/java/**

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.include

includes

include パラメーターのリストです。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.includes

projectNameTemplate

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

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.projectNameTemplate

publish

ローカル解析の結果を DTP サーバーにパブリッシュするかどうかを指定します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.publish

report

レポートが作成されるディレクトリを指定します。デフォルト値は ${project.build.directory}/jtest です。

• 型: java.io.File
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.report

resource

解析の入力スコープを指定します。リソースが指定されていない場合、ビルドされたすべてのプロジェクトのリソースが解析されます。

次のパターンを使用してパスを指定します: ${ProjectName}/my/src/dir/my/package/file.java"以下のワイルドカードを使用できます。

• ? - 1 文字に一致します。
• * - (パスの区切り文字 / を除く) 0 個以上の文字に一致します 。
• ** - パス区切り文字 / を含むパス全体に一致します。

Jtest Maven プラグインは ${ProjectName} を ${artifactId}:${groupId} に解決することに注意してください。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.resource

resources

resource パラメーターの List です。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.resources

settings

カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。

• 型: java.io.File
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.settings

settingsList

settings パラメーターのリストです。Maven 3.0.3 以降でサポートされます。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.io.File[]
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.settingsList

showDetails

より詳細な進捗情報を表示します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.showdetails

showSettings

現在の設定およびカスタマイズの状況を出力します。各構成エントリがどこで指定されているか (.properties ファイルなど) を表示します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.showsettings

skip

Jtest の実行のスキップを有効または無効にします。true を設定した場合、jtest.data.json データ ファイルだけが生成されます。

• 型: java.lang.String
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.skip

完全名: com.parasoft.jtest:jtest-maven-plugin:2020.1.0:agent

ビルド モジュールに基づいて Jtest Agent 設定を生成し、agentPropertyNames パラメーターで指定されたプロパティ ファイルの javaagent VM 引数 を設定します。

デフォルトでは、特定のプロパティによって maven-surefire-plugin および eclipse-test-plugin に javaagent VmArg をインジェクトします。

属性

• 実行するには Maven プロジェクトが必要です。
• スコープ: compile の成果物の依存関係を解決する必要があります。
• 導入されたバージョン: 1.2.4
• デフォルトでは lifecycle phase: process-test-classes にバインドします。

必須パラメーター

任意パラメーター

パラメーターの詳細

agentPropertyNames

Jtest Agent JVM 引数を渡すために使用するプロパティのカンマ区切りのリストです。

• 型: java.lang.String
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.agentPropertyNames
• デフォルト値: argLine,tycho.testArgLine

agentServerEnabled

Agent サーバーの有効化スイッチです。

• 型: boolean
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.agentServerEnabled
• デフォルト値: false

agentSettings

エージェントの設定が生成される場所です。絶対パスまたは ${project.build.directory}/jtest ディレクトリからの相対パスを指定します。デフォルトの場所は ${project.build.directory}/jtest/agent.properties です。指定されたパスが既存のファイルを指している場合、そのファイルが上書きされます。

• 型: java.lang.String
• 導入されたバージョン: 1.2.2
• 必須: いいえ
• ユーザー プロパティ: jtest.agentSettings
• デフォルト値: agent.properties

autostartAgent

自動的にカバレッジの収集を有効化するスイッチです。

• 型: boolean
• 導入されたバージョン: 1.0.7
• 必須: はい
• ユーザー プロパティ: jtest.autostartAgent
• デフォルト値: true

coverage

カバレッジの収集の設定を行うパラメーターのセットです。

• jtest.coverage.skip - カバレッジを無効化します。

次のパラメーターは、インストゥルメント対象のクラスを指定します (インストゥルメントされたクラスのカバレッジだけが収集されます):

• jtest.coverage.includes - インストゥルメントに含めるクラスの <Glob> パターンを指定します。カバレッジ情報が収集されます。
• jtest.coverage.excludes - インストゥルメントから除外するクラスの <Glob> パターンを指定します。カバレッジ情報は収集されません。

次のパラメーターは、インストゥルメント対象のテスト クラスを指定します (個々のインストゥルメントされたテスト ケースにはカバレッジ情報が割り当てられます):

• jtest.coverage.testIncludes - インストゥルメントに含めるテスト クラスの <Glob> パターンです。テスト ケースにはカバレッジ情報が割り当てられます。
• jtest.coverage.testExcludes - インストゥルメントから除外するテスト クラスの <Glob> パターンです。テスト ケースにはカバレッジ情報が割り当てられません。
  
  

• 型: com.parasoft.jtest.plugin.CoverageConfig
• 導入されたバージョン: 1.2.4
• 必須: いいえ

enableJacoco

• 型: boolean
• 導入されたバージョン: 2021.1.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.enableJacoco

home

Jtest のインストール ディレクトリです。jtestcli を実行し、Jtest Agent ライブラリにアクセスするために必要です。

• 型: java.io.File
• 導入されたバージョン: 1.1.0
• 必須: はい
• ユーザー プロパティ: jtest.home

ignoredIds

無視するコンパイル ID の List です。

• 型: java.lang.String[]
• 導入されたバージョン: 1.0.4
• 必須: いいえ
• ユーザー プロパティ: jtest.ignoredids

projectNameTemplate

プロジェクト名のテンプレートです。独自のテンプレートを作成して json のプロジェクト名を作成できます。以下のオプションがあります。[groupId]、[artifactId]、[version]、[basedir]

• 型: java.lang.String
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.projectNameTemplate

完全名: com.parasoft.jtest:jtest-maven-plugin:2020.1.0:monitor

このゴールは、Maven のレポートとして使用する必要があります。ビルドをスキャンして Jtest Java エージェントの設定を生成し、monitorLocation パラメーターで指定された場所にモニター パッケージを作成します。

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

• static_coverage.xml - 静的カバレッジ データを格納したファイル
• agent.jar - Jtest Java カバレッジ エージェントの jar アーカイブ
• agent.properties - ビルド処理中に生成されたスコープ パラメーターおよびその他の属性を含むエージェント設定ファイル
• agent.sh/agent.bat - アプリケーションのモニタリングに必要な Jtest Java エージェント VM 引数を生成するスクリプト
• opentelemetry-javaagent.jar および jtest-otel-ext.jar - マルチユーザー カバレッジ モードで使用されます。元の OpenTelemetry Java エージェントとそれに対応する Jtest 拡張です。この拡張は、収集されたカバレッジを特定のユーザーに割り当てるのに必要なデータを収集します。これらのファイルは、<INSTALL_DIR>/integration/coverage ディレクトリからコピーされます。

属性

• 実行するには Maven プロジェクトが必要です。
• アグリゲータ プラグインとして実行されます。
• スコープ: compile の成果物の依存関係を解決する必要があります。
• 導入されたバージョン: 1.2.4

任意パラメーター

パラメーターの詳細

agentServerEnabled

Agent サーバーの有効化スイッチです。

• 型: boolean
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.agentServerEnabled
• デフォルト値: true

autostartAgent

自動的にカバレッジの収集を有効化するスイッチです。

• 型: boolean
• 導入されたバージョン: 1.0.7
• 必須: はい
• ユーザー プロパティ: jtest.autostartAgent
• デフォルト値: true

compilation

手動コンパイル データの記述です。詳細については「POM ファイルでのコンパイル データの手動カスタマイズ」ページを参照してください。

• 型: org.codehaus.plexus.configuration.PlexusConfiguration
• 導入されたバージョン: 1.0.4
• 必須: いいえ

compilations

手動コンパイル データの記述のリストです。詳細については「コンパイル データの手動カスタマイズ」を参照してください。

• 型: org.codehaus.plexus.configuration.PlexusConfiguration
• 導入されたバージョン: 1.0.4
• 必須: いいえ

coverage

• jtest.coverage.skip - カバレッジを無効化します。

次のパラメーターは、インストゥルメント対象のクラスを指定します (インストゥルメントされたクラスのカバレッジだけが収集されます):

• jtest.coverage.includes - インストゥルメントに含めるクラスの <Glob> パターンを指定します。カバレッジ情報が収集されます。
• jtest.coverage.excludes - インストゥルメントから除外するクラスの <Glob> パターンを指定します。カバレッジ情報は収集されません。

Glob パターンは、classpath (パス区切り文字: /) からの *.class ファイルの相対パスと比較されます。/ )

• 型: com.parasoft.jtest.plugin.CoverageConfig
• 導入されたバージョン: 1.2.4
• 必須: いいえ

dataUpdate

ビルドから収集されたコンパイル データを手動で更新できます。

• サポートされるアクション: prepend, append, and set.
• サポートされるデータ型: classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode (set のみ)、encoding (set のみ)
• スコープ: 収集されたすべてのプロジェクト データが更新されます。

• 型: java.lang.String
• 導入されたバージョン: 1.2.9
• 必須: いいえ
• ユーザー プロパティ: jtest.dataUpdate

詳細については「POM ファイルでのコンパイル データの手動カスタマイズ」および「コンパイル データ モデル」を参照してください。

enableJacoco

• 型: boolean
• 導入されたバージョン: 2021.1.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.enableJacoco

exclude

選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します: path:/home/user/project/src/test/java/**

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.exclude

excludes

exclude パラメーターのリストです。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.excludes

home

Jtest のインストール ディレクトリです。

• 型: java.io.File
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.home

ignoredIds

無視するコンパイル ID の List です。Maven 3.0.3 以降でサポートされます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.0.4
• 必須: いいえ
• ユーザー プロパティ: jtest.ignoredids

include

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを含めます: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを含めますが、サブパッケージのファイルは含めません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを含めます: path:/home/user/project/src/test/java/**

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.include

includes

include パラメーターのリストです。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.includes

monitorLocation

モニター パッケージが作成される場所へのパスです。

• 型: java.io.File
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.monitorLocation
• デフォルト値: ${project.build.directory}/jtest/monitor/monitor.zip

projectNameTemplate

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

• 型: java.lang.String
• 導入されたバージョン: 1.2.4
• 必須: いいえ
• ユーザー プロパティ: jtest.projectNameTemplate

publish

ローカル解析の結果を DTP サーバーにパブリッシュするかどうかを指定します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.publish

resource

解析の入力スコープを指定します。リソースが指定されていない場合、ビルドされたすべてのプロジェクトのリソースが解析されます。

次のパターンを使用してパスを指定します: ${ProjectName}/my/src/dir/my/package/file.java"以下のワイルドカードを使用できます。

• ? - 1 文字に一致します。
• * - (パスの区切り文字 / を除く) 0 個以上の文字に一致します 。
• ** - パス区切り文字 / を含むパス全体に一致します。

Jtest Maven プラグインは ${ProjectName} を ${artifactId}:${groupId} に解決することに注意してください。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.resource

resources

resource パラメーターのリストです。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.lang.String[]
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• ユーザー プロパティ: jtest.resources

settings

カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。

• 型: java.io.File
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.settings

settingsList

settings パラメーターのリストです。Maven 3.0.3 以降でサポートされます。Maven 3.0.3 以降では、プロパティを使用して設定できます。

• 型: java.io.File[]
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.settingsList

showDetails

より詳細な進捗情報を表示します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.showdetails

showSettings

現在の設定およびカスタマイズの状況を出力します。各構成エントリがどこで指定されているか (.properties ファイルなど) を表示します。

• 型: java.lang.String
• 導入されたバージョン: 1.0.0
• 必須: いいえ
• ユーザー プロパティ: jtest.showsettings

skip

Jtest の実行のスキップを有効または無効にします。true を設定した場合、jtest.data.json データ ファイルだけが生成されます。

• 型: java.lang.String
• 導入されたバージョン: 1.1.0
• 必須: いいえ
• デフォルト値: false
• ユーザー プロパティ: jtest.skip

このゴールは、Jtest に付属のテスト影響分析プラグインによって設定され、プロジェクトのテスト影響分析の実行を可能にします (「テスト影響分析」を参照)。

必須パラメーター

任意パラメーター