このセクションは、Maven 用 Jtest ゴールおよびパラメーターの情報を提供します。以下のゴールがあります。

jtest:jtest

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

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

属性

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

パラメーター

名前設定可能な値/データ型導入されたバージョン説明
compilationPlexusConfiguration1.0.4手動コンパイル データの記述です。詳細については「コンパイル データの手動カスタマイズ」を参照してください。
compilationsPlexusConfiguration1.0.4手動コンパイル データの記述のリストです。詳細については「コンパイル データの手動カスタマイズ」を参照してください。
configString1.0.0

ビルトイン/DTP/ユーザー定義テスト コンフィギュレーション名です。

ユーザー プロパティ: jtest.config

dataUpdateString1.2.9

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

ユーザー プロパティ: jtest.dataUpdate

excludeString1.0.0

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

ユーザー プロパティ: jtest.exclude

excludes
1.1.0

exclude パラメーターの List です。

ユーザー プロパティ: jtest.excludes

excludeTestSourcestrue | false1.1.0

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

デフォルト値: true

ユーザー プロパティ: jtest.excludeTestSources

failtrue | false

1.0.0  

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

デフォルト値: false

ユーザー プロパティ: jtest.fail

forceTestReportsImporttrue | false
1.0.0

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

デフォルト値: false

ユーザー プロパティ: jtest.forceTestReportsImport

homePath1.1.0

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

ユーザー プロパティ: jtest.home

ignoredIds


1.0.4

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

ユーザー プロパティ: jtest.ignoredids

includeString1.0.0

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。

ユーザー プロパティ: jtest.include

includes
1.1.0

include パラメーターのリストです。

ユーザー プロパティ: jtest.includes

projectNameTemplateString1.0.0

プロジェクト名のテンプレートです。[groupId]、[artifactId]、[version] および [basedir] オプションを使用してパターンを構成できます。

ユーザー プロパティ: jtest.projectNameTemplate

publishtrue | false1.0.0

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

ユーザー プロパティ: jtest.publish

reportPath1.0.0

レポートが作成されるディレクトリを指定します。

ユーザー プロパティ: jtest.report

resourceString1.0.0

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

ユーザー プロパティ: jtest.resource

resources
1.1.0

resource パラメーターの List です。

ユーザー プロパティ: jtest.resources

settingsPath1.0.0

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

ユーザー プロパティ: jtest.settings

settingsList
1.0.0

settings パラメーターのリストです。

ユーザー プロパティ: jtest.settingsList

showDetailstrue | false1.0.0

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

ユーザー プロパティ: jtest.showdetails

showSettingstrue | false1.0.0

現在の設定とカスタマイズの内容を出力します。

ユーザー プロパティ: jtest.showsettings

skiptrue | false1.1.0

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

デフォルト値: false

ユーザー プロパティ: jtest.skip

パラメーターの詳細

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 など) を認識できない場合、デフォルトの場所からテスト結果をインポートします。

このパラメーターを "clean" ゴールとともに使用し、Jtest プラグインが前の実行からテスト結果をインポートするのを防ぐことを推奨します。

  • : 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 のプロジェクト名と合わせることができます。

すでに DTP と統合されているプロジェクトのパターンを変更すると、DTP はプロジェクトを認識できなくなります。DTP は、パターンを変更した後のプロジェクトを別のプロジェクトとして認識します。詳細については、DTP のマニュアルを参照してください。

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

publish

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

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

report

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


resource

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

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

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

(info) 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

jtest:agent

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

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

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

コマンド ライン実行

コマンド ラインから実行する場合は、このゴールを実行する前に、必ずテストおよびクラスをコンパイルしてください (test-compile フェーズ)。

属性

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

必須パラメーター

名前設定可能な値/データ型導入されたバージョン説明
autostartAgenttrue | false1.0.7

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

デフォルト値: true

ユーザー プロパティ: jtest.autostartAgent

homePath1.1.0

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

ユーザー プロパティ: jtest.home

名前設定可能な値/データ型導入されたバージョン説明
agentPropertyNamesString1.2.4

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

デフォルト値: fargLine,tycho.testArgLine

ユーザー プロパティ: jtest.agentPropertyNames

agentServerEnabledtrue | false1.2.4

Agent サーバーを有効化します。

デフォルト値: false

ユーザー プロパティ: jtest.agentServerEnabled

agentSettingsPath1.2.2

エージェントの設定が生成される場所です。

デフォルト値: ${project.build.directory}/jtest/agent.properties

ユーザー プロパティ: jtest.agentSettings

coverage
1.2.4

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

  • jtest.coverage.skip - カバレッジを無効化します。
  • jtest.coverage.includes - インストゥルメントに含めるクラスの <Glob> パターンを指定します。カバレッジ情報が収集されます。
  • jtest.coverage.excludes - インストゥルメントから除外するクラスの <Glob> パターンを指定します。カバレッジ情報は収集されません。
  • jtest.coverage.testIncludes - インストゥルメントに含めるテスト クラスの <Glob> パターンです。テスト ケースにはカバレッジ情報が割り当てられます。
  • jtest.coverage.testExcludes - インストゥルメントから除外するテスト クラスの <Glob> パターンです。テスト ケースにはカバレッジ情報が割り当てられません。
enableJacocotrue | false2021.1.0

Jacoco エンジンを使用した行カバレッジの収集を有効/無効にします。

デフォルト値: false

ユーザー プロパティ: jtest.enableJacoco

ignoredIds
1.0.4

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

ユーザー プロパティ: jtest.ignoredids

projectNameTemplateString1.2.4

プロジェクト名のテンプレートです。

ユーザー プロパティ: jtest.projectNameTemplate


パラメーターの詳細

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

jtest:monitor

完全名: 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 引数を生成するスクリプト

コマンド ライン実行

コマンド ラインから実行する場合は、このゴールを実行する前に、必ずクラスをコンパイルしてください (compile フェーズ)。

属性

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

任意パラメーター

名前設定可能な値/データ型導入されたバージョン説明
agentServerEnabledtrue | false1.2.4

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

デフォルト値: true

ユーザー プロパティ: jtest.agentServerEnabled

autostartAgenttrue | false1.0.7

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

デフォルト値: true

ユーザー プロパティ: jtest.autostartAgent

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

カバレッジの構成ブロックです。以下のパラメーターをネストできます:

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

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

dataUpdateString1.2.9

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

ユーザー プロパティ: jtest.dataUpdate

enableJacocotrue | false

Jacoco エンジンを使用した行カバレッジの収集を有効/無効にします。

デフォルト値: false

ユーザー プロパティ: jtest.enableJacoco

excludeString1.0.0

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

ユーザー プロパティ: jtest.exclude

excludes


1.1.0

exclude パラメーターのリストです。

ユーザー プロパティ: jtest.excludes

homePath1.1.0

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

ユーザー プロパティ: jtest.home

ignoredIds
1.0.4

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

ユーザー プロパティ: jtest.ignoredids

includeString1.0.0

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。

ユーザー プロパティ: jtest.include

includes
 1.1.0

include パラメーターのリストです。

ユーザー プロパティ: jtest.includes

monitorLocationPath1.2.4

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

デフォルト値: ${project.build.directory}/jtest/monitor/monitor.zip

ユーザー プロパティ: jtest.monitorLocation

projectNameTemplateString1.2.4

プロジェクト名のテンプレートです。

ユーザー プロパティ: jtest.projectNameTemplate

publishtrue | false1.0.0

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

ユーザー プロパティ: jtest.publish

resourceString1.0.0

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

ユーザー プロパティ: jtest.resource

resources
1.1.0

resource パラメーターのリストです。

ユーザー プロパティ: jtest.resources

settingsPath1.0.0

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

ユーザー プロパティ: jtest.settings

settingsList
1.0.0

settings パラメーターのリストです。

ユーザー プロパティ: jtest.settingsList

showDetailstrue | false1.0.0

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

ユーザー プロパティ: jtest.showdetails

showSettingstrue | false1.0.0

現在の設定とカスタマイズの内容を出力します。

ユーザー プロパティ: jtest.showsettings

skiptrue | false1.1.0

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

デフォルト値: false

ユーザー プロパティ: jtest.skip

パラメーターの詳細

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 のプロジェクト名と合わせることができます。

すでに DTP と統合されているプロジェクトのパターンを変更すると、DTP はプロジェクトを認識できなくなります。DTP は、パターンを変更した後のプロジェクトを別のプロジェクトとして認識します。詳細については、DTP のマニュアルを参照してください。

  • : 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 個以上の文字に一致します 。
  • ** - パス区切り文字 / を含むパス全体に一致します。

(info) 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

tia:affected-tests

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

必須パラメーター

名前ユーザー プロパティ設定可能な値/データ型説明
referenceCoverageFilejtest.referenceCoverageFilePath | URL

解析時に Jtest によって生成された coverage.xml ファイルへのパスです。ファイルには実行中に収集されたカバレッジ データが保存されています。

URL を指定した場合、ファイルは Jtest 実行ディレクトリにダウンロードされ、clean コマンドを使用して Maven を実行するたびに削除されます。デフォルトのダウンロードされる場所を変更するには、referenceStore パラメーターを設定します。

デフォルト値: target/jtest/reference-store/coverage.xml

referenceReportFile

jtest.referenceReportFilePath | URL

解析時に Jtest によって生成された report.xml ファイルへのパスです。ファイルには実行された単体テストに関する情報が保存されています。

URL を指定した場合、ファイルは Jtest 実行ディレクトリにダウンロードされ、clean コマンドを使用して Maven を実行するたびに削除されます。デフォルトのダウンロードされる場所を変更するには、referenceStore パラメーターを設定します。

デフォルト値: target/jtest/reference-store/report.xml

jtestHomejtest.homePath

Jtest のインストール ディレクトリへのパスです。Maven の設定または JTEST_HOME 環境変数によってすでに Jtest のインストール ディレクトリが設定されている場合は、このパラメーターは不要です。

任意パラメーター

名前ユーザー プロパティ設定可能な値/データ型説明

referenceStore

jtest.referenceStorePath

referenceCoverageFile および referenceReportFile パラメーターで指定された URL からダウンロードした参照ファイルを保存するキャッシュ ディレクトリへのパスです。

ファイルが指定されたディレクトリから削除されるまで、キャッシュ ファイルはテスト影響分析のベースラインとして使用されます。ファイルが削除されると、URL から再ダウンロードされます。

runFailedTestsjtest.runFailedTeststrue | false

変更の影響を受けていなくても、前回失敗したすべてのテストを現在のテスト実行に含めます。

デフォルト値: false

runModifiedTestsjtest.runModifiedTeststrue | false

変更されたテストおよび新規テストの両方をテスト実行に含めます。

デフォルト値: true

settingsjtest.settingsPath

カスタム設定を含む .properties ファイルへのパスを指定します。

settingsListjtest.settingsList

settings パラメーターのリストです。この設定で複数のファイルが指定されると、実行の前にマージされます。

Jtest インストール ディレクトリにある jtest.properties ファイルの設定は自動的に含められます。

testFilterjtest.testFilterパターン

インクルードまたはエクスクルードする追加のテストを指定します。複数のファイル名に一致する glob パターンを使用できます。

次のコマンドラインでは、Jtest は **/Test*.java というパターンに一致するすべてのテストを再実行し、解析スコープ内の ProblemTest.java という名前のファイルをスキップします。

-Djtest.testFilter="**/Test*.java, !**/ProblemTest.java"

再実行するテストを手動でフィルタリングする」を参照してください。

  • No labels