Page History

完全名: 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

任意パラメーター

パラメーターの詳細

Anchor
agentServerEnabled_2 agentServerEnabled_2

agentServerEnabled

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

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

Anchor
autostartAgent_2 autostartAgent_2

autostartAgent

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

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

Anchor
compilation_2 compilation_2

compilation

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

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

Anchor
compilations_2 compilations_2

compilations

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

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

Anchor
coverage_2 coverage_2

coverage

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

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

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

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

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

Anchor
dataUpdate_2 dataUpdate_2

dataUpdate

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

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

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

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

Anchor
enableJacoco_2 enableJacoco_2

enableJacoco

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

Anchor
exclude_2 exclude_2

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

Anchor
excludes_2 excludes_2

excludes

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

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

Anchor
home_2 home_2

home

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

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

Anchor
ignoredIds_2 ignoredIds_2

ignoredIds

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

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

Anchor
include_2 include_2

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

Anchor
includes_2 includes_2

includes

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

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

Anchor
monitorLocation_2 monitorLocation_2

monitorLocation

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

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

Anchor
projectNameTemplate_2 projectNameTemplate_2

projectNameTemplate

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

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

Anchor
publish_2 publish_2

publish

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

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

Anchor
resource_2 resource_2

resource

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

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

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

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

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

Anchor
resources_2 resources_2

resources

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

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

Anchor
settings_2 settings_2

settings

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

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

Anchor
settingsList_2 settingsList_2

settingsList

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

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

Anchor
showDetails_2 showDetails_2

showDetails

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

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

Anchor
showSettings_2 showSettings_2

showSettings

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

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

Anchor
skip_2 skip_2

skip

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

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