このセクションの内容

はじめに

実行中のアプリケーションで手動または自動での機能テストを実行しながらカバレッジデータをモニターおよび収集できます。カバレッジデータおよびテスト結果を DTP サーバーにレポートし、データをマージして関連付けることもできます。アプリケーションカバレッジ情報を DTP のカバレッジエクスプローラー (詳細は DTP ユーザーズガイドの「カバレッジエクスプローラー」を参照) に表示し、アプリケーションがどの程度テストされたかや、テストの品質を知ることができます。

前提条件

Java 1.8 - 17 の実行時カバレッジを収集できます。

Java JDK 8 でのバイトコードの改行の計算方法は、それより前のバージョンの Java と異なります。そのため、カバレッジの結果が変わる場合があります。

カバレッジレポートにアプリケーションのソースコードに関する情報を含めるには、次のコンポーネントが必要です。

Apache Maven、Gradle、または Ant ビルドシステム

ソース管理システムを使用する場合、適切にソース管理システムを設定します。「ソース管理システムの設定」を参照してください。

jtestcov ツールを使用するには、マシンに Java 11 以降がインストールされている必要があります。Oracle Java SE および OpenJDK がサポートされています。他のフリーやオープンソースの実装は、カバレッジツールの正常な動作を妨げる問題の原因になる可能性があります。JAVA_HOME 変数を設定し、システムの PATH に追加することを推奨します。jtestcov の使用方法については、「カバレッジレポートの作成と DTP へのデータのアップロード」および「jtestcov のコマンドラインオプション」を参照してください。

プロセスの概要

Jtest には、カバレッジエージェントというコンポーネントが付属しています。カバレッジエージェントは、テスト対象アプリケーション (AUT) にアタッチされ、AUT の実行されたコードをモニターします。AUT にカバレッジエージェントをアタッチすると、REST API が公開され、テストおよびテストセッションの開始および終了をマークできるようになります。

カバーされるコード行に関するメタデータ (静的カバレッジデータ) は、アプリケーションのビルドプロセスの一環として特別なテストコンフィギュレーションを実行するか、アプリケーションのバイナリをスキャンすることによって収集されます。テスト実行時には、カバレッジエージェントとのやりとりが動的カバレッジマップに書き込まれます。このマップには、実行されたコード行を示すマーカーが記録されます。

Jtest は、この動的カバレッジマップと静的カバレッジデータを処理します。カバレッジ情報を保存した coverage.xml が生成され、DTP に送信されます。DTP は、カバレッジデータを受信すると、カバレッジイメージにロードします。カバレッジイメージは、同じビルド ID を持つ複数の実行のカバレッジデータを集約することを可能にする特別なタグです。カバレッジイメージにより、カバレッジ情報と特定のテストを関連付けることが可能になります。

また、Jtest は実行時カバレッジおよび実行されたクラスに関する一般的な情報だけが含まれるアプリケーションカバレッジを収集することもできます。これには、カバーされた行以外のクラス構造の詳細は含まれません。簡略化されたレポートが DTP に送信され、DTP 上の既存のカバレッジデータに付加されます。クラス構造に関する情報 (静的カバレッジデータ) がすでに DTP に存在する場合、カバレッジデータを参照できます。

テスト実行ツールの結果 (SOAtest のテスト、手動テストなど) も report.xml という形で DTP に送信されます。カバレッジデータファイルとレポートのビルド ID が一致すると、DTP はそれらのデータを関連付け、カバレッジ情報に表示します。

カバレッジレポートを作成し、DTP にアップロードするには、jtestcov または jtestcli を使用します。jtestcov は、カバレッジ専用のツールであり、カバレッジレポートの生成に関してより多くのオプションがあります。「カバレッジレポートの作成と DTP へのデータのアップロード」を参照してください。jtestcov.jar ファイルは <INSTALL_DIR>/integration ディレクトリにあります。jtestcov はスタンドアロンツールであり、Jtest のインストールディレクトリ外にコピーして単独で使用できます。そのため、テストフローとの統合が容易です。jtestcov コマンドラインオプションの詳細は、「jtestcov のコマンドラインオプション」を参照してください。

カバレッジ収集のためのテスト対象アプリケーション (AUT) の構成

AUT の準備には、以下の手順が含まれます。

任意: 事前設定済みのカバレッジエージェント構成および静的カバレッジファイルを含むモニターパッケージを生成します。静的カバレッジファイルには、ユーザークラス、メソッド、行などの情報が記録されます。「モニターパッケージの生成」を参照してください。
実行時カバレッジを収集できるようカバレッジエージェントを設定します。「カバレッジエージェントの構成」を参照してください。
AUT にカバレッジエージェントをアタッチします。「テスト対象アプリケーション (AUT) へのカバレッジエージェントのアタッチ」を参照してください。

モニターパッケージの生成

モニターパッケージは、ビルドプロセス中に Jtest Maven、Gradle または Ant プラグインによって生成されます。カバレッジとAUTのソースコードが正しく照合されるよう、AUT のビルドに使用したのと同じビルドシステムと Java のバージョンを使用してパッケージを生成してください。

このパッケージには以下が含まれます。

static_coverage.xml - 静的カバレッジ情報が保存されています。
agent.jar - Jtest Java カバレッジエージェントの jar アーカイブ (<INSTALL_DIR>/integration/coverage ディレクトリからコピーされます)。
agent.properties - エージェントの設定ファイルです。ビルドプロセス実行中に生成されたスコープパラメーターや、他の属性が保存されています。
agent.sh/agent.bat - エージェントを AUT プロセスにアタッチするために必要な Jtest Java エージェントの VM 引数を生成するスクリプトです。

パッケージは、ソースコードがあるビルドマシン上で生成される必要があります。生成された静的カバレッジファイルは、コードが変更されるまで使用できます。

パッケージを生成するには、AUT のメインディレクトリで、次のコマンドを実行します。

Maven

mvn package jtest:monitor

Gradle

gradle assemble jtest-monitor -I [INSTALL]/integration/gradle/init.gradle

Ant

ant -lib [INSTALL]/integration/ant/jtest-ant-plugin.jar -listener com.parasoft.Listener jtest-monitor

Ant は、モニタータスクを実行する前にすべてのクラスをコンパイルすることを要求します。ビルドの前にプロジェクトを変更し、正しい順序になるようタスクを設定してください。以下はターゲットの設定例です。

<target name="jtest-monitor" depends="compile">
             <jtest:monitor/>
</target>

monitor.zip パッケージが生成され、ビルド出力ディレクトリに置かれます。その場所へのパスがコンソールに出力されます。

カバレッジエージェントの構成

通常、アプリケーションサーバーには複数のアプリケーションがあります。さらに、共通サーバークラスまたはアプリケーションライブラリはインストゥルメントする必要がありません。Jtest がカバレッジを収集する必要があるのは、アプリケーションのソースコードだけです。すべてのクラスをインストゥルメントすると、時間がかかりすぎる場合があります。

サーバー上のアプリケーションは既にビルドされており、ソースコードからどのクラスが生成されたかに関する情報を収集することはできません。このため、Jtest エージェントのスコープを適切に設定することが非常に重要です。

カバレッジエージェントは、以下の方法で設定できます。

agent.properties ファイルを使用して
AUT にカバレッジエージェントをアタッチする際に -javaagent への引数を使用して。「テスト対象アプリケーション (AUT) へのカバレッジエージェントのアタッチ」を参照してください。

agent.properties および agent.jar ファイルは <INSTALL_DIR>/integration/coverage ディレクトリにあります。agent.properties ファイルのデフォルトプロパティを変更してカバレッジエージェントを適切に設定できます。以下は、agent.properties ファイルを使ってカバレッジエージェントを設定する例です。

jtest.agent.autostart=false
jtest.agent.serverEnabled=true
jtest.agent.associateTestsWithCoverage=false
jtest.agent.includes=com/myapp/**
jtest.agent.runtimeData=[...]

monitor.zip パッケージを生成済みの場合、パッケージに含まれている agent.properties ファイルを使用できます。このファイルには、ビルドプロセス実行時に生成されたスコープパラメーターやその他の属性がすでに含まれています。

コマンドラインで -javaagent にプロパティを追加するには、jtest.agent 接頭辞を削除して名前を変更する必要があります。例:

-javaagent:"[path to agent dir]\agent.jar"=settings="[path to agent properties file]\agent.properties",autostart=true

-javaagent への引数として指定されたプロパティは、agent.properties ファイルで設定されたプロパティを上書きします。上記の例の場合、autostart=true はagent.properties ファイルの jtest.agent.autostart=false を上書きします。

以下の表は、カバレッジエージェントを設定するために使用できる全プロパティの一覧です。

プロパティ	説明
`jtest.agent.runtimeData`	実行時データが保存される場所です。次の例では、C:/tmp/myapp/ ディレクトリに `runtime_` という接頭辞の付いたファイルが作成されます。 `'C:/tmp/myapp/runtime'`
`jtest.agent.includes`	インストゥルメントするクラスのパターンをカンマ区切りのリストで指定します。次のワイルドカードがサポートされています。 `` はゼロ個以上の文字に一致します。 `` は複数のディレクトリレベルに一致します。次の例では、`com.myapp.data` パッケージのすべてのクラスと `com.myapp.common` で始まるパッケージおよびサブパッケージのすべてのクラスがインストゥルメントされます。 `com/myapp/data/,com/myapp/common/**`
`jtest.agent.excludes`	インストゥルメントから除外するクラスのパターンをカンマ区切りのリストで指定します。次のワイルドカードがサポートされています。 `` はゼロ個以上の文字に一致します。 `` は複数のディレクトリレベルに一致します。次の例では、`com.myapp.transport` パッケージのすべてのクラスと `com.myapp.autogen` で始まるパッケージおよびサブパッケージのすべてのクラスがインストゥルメントから除外されます。 `com/myapp/transport/,com/myapp/autogen/**`
`jtest.agent.autostart`	実行時データの自動収集を有効/無効にします。デフォルト値は `true` です。
`jtest.agent.port`	エージェントの通信ポートを設定します。デフォルト値は `8050` です。
`jtest.agent.debug`	コンソールへの冗長な出力を有効/無効にします。デフォルト値は `false` です。
`jtest.agent.collectTestCoverage`	テストケースのカバレッジ情報の収集を有効/無効にします。デフォルト値は `false` です。
`jtest.agent.enableMultiuserCoverage`	複数ユーザーの Web アプリケーションカバレッジの収集を有効/無効にします。デフォルト値は `false` です。このプロパティを true に設定すると、Coverage Agent Manager を使って複数ユーザーのカバレッジを収集できます。詳細については Parasoft DTP ドキュメントの「Coverage Agent Manager (CAM)」のセクションを参照してください。
`jtest.agent.associateTestsWithCoverage`	カバレッジと特定のテストの関連付けを有効/無効にします。デフォルト値は `true` です。
`jtest.agent.testid`	エージェント実行時にカバレッジが関連付けられる初期テスト ID です。
`jtest.agent.enableJacoco`	Jacoco エンジンを使用した行カバレッジの収集を有効/無効にします。

テスト対象アプリケーション (AUT) へのカバレッジエージェントのアタッチ

任意: monitor.zip パッケージを使用したい場合:
1. パッケージの内容をサーバーマシンに展開します。
2. gent.sh/agent.bat スクリプトを実行して Jtest Java エージェントの VM 引数を生成します。スクリプトは、コンソールに -javaagent VM 引数を出力します。
-javaagent フラグを使用してエージェントを AUT にアタッチします。結果は runtime_coverage サブディレクトリに出力されます。
Jtest Agent VM argument: -javaagent:"[path to agent dir]\agent.jar"=settings="[path to agent properties file]\agent.properties",runtimeData="[path to runtime coverage folder]"
-javaagent を使用したカバレッジエージェントの構成については「カバレッジエージェントの構成」を参照してください。
アプリケーションサーバーの起動スクリプトに -javaagent フラグを追加してエージェントを AUT にアタッチします。AUT にカバレッジエージェントをアタッチすると、エージェントを制御するための REST API が公開されます。
AUT を再起動します (「Web アプリケーションカバレッジのチュートリアル」の手順 5, 3 を参照)。
ブラウザーに次の URL を入力して、カバレッジエージェントが設定されていることを確認します。
[application_host]:8050/status/
アプリケーションが適切に構成されている場合、API は次のデータを返します。

HTTPS 経由での Coverage Agent への接続

デフォルトでは、カバレッジエージェントは HTTP プロトコル経由で利用できます。HTTPS 経由で接続するには、Jtest Agent VM 引数に次のオプションを追加し、カバレッジエージェントを設定する必要があります (「テスト対象アプリケーション (AUT) へのカバレッジエージェントのアタッチ」を参照)。

useSSL=true
certificateStorePath=[キーストアファイルへのパス]
certificateStorePassword=[キーストアファイルのパスワード]
certificateStoreType=[キーストアファイルのフォーマット]
certificateKeyPassword=[SSL 証明書へのパスワード]

アプリケーションサーバーの起動スクリプトに追加される Jtest Agent VM 引数は次のようになります。

-javaagent:"[path to agent dir]\agent.jar"=settings="[path to agent properties file]\agent.properties",runtimeData="[path to runtime coverage folder]",useSSL=true,certificateStorePath="F:\certificates\keystore.jks",certificateStorePassword=4!ij?ffQMk,certificateStoreType="JKS",certificateKeyPassword=dhW!34

こうすると、カバレッジエージェントはテスト対象アプリケーション用に設定された SSL 証明書を認識できるようになります。

アプリケーション用に SSL 証明書を設定する方法はいろいろあります。ブラウザーを使用している場合、信頼された証明書のリストに証明書を追加するオプションがあるかもしれません。別の Java プログラムを使用している場合、Java VM の信頼された証明書ファイルに証明書をインポートするか、Java クライアントのコマンドラインに次の Java VM 引数を追加できます。

-Djavax.net.ssl.trustStore=[キーストアファイルへのパス]
-Djavax.net.ssl.trustStoreType=[キーストアファイルのフォーマット]
-Djavax.net.ssl.trustStorePassword=[キーストアファイルのパスワード]

テストを実行してランタイムカバレッジを収集する

SOAtest を使用して機能テストを実行することも、Coverage Agent Manager (CAM) とともに手動でテストを実行することもできます。テストセッション実行の詳細については、SOAtest ユーザーガイドまたは CAM のマニュアルを参照してください。

テスト実行時の処理

SOAtest は実行時カバレッジを収集し、データをを DTP に送信します。
CAM はランタイムカバレッジとテスト結果を収集します。これらは手動でダウンロードする必要があります。次に行う操作
- 手動で DTP にテスト結果をアップロードします。「DTP への結果のアップロード」を参照してください。
- ランタイムカバレッジと静的カバレッジをマージし、DTP にアップロードします。「カバレッジレポートの作成と DTP へのデータのロード」を参照してください。

DTP への結果のアップロード

CAM とともに Jtest を使用する場合

DTP のインターフェイスで [Report Center] に移動します。
歯車のアイコンをクリックして [Report Center 設定] > [その他の設定] > [Report Center の管理] > [ツール] > [Data Collector アップロードフォーム] をクリックします (管理者権限が必要です)。
[ファイルの選択] をクリックし、CAM からダウンロードした report.xml ファイルを選択します。
[アップロード] ボタンをクリックし、ファイルを DTP にアップロードします。

SOAtest を使用する場合、テスト実行時にテスト結果が自動的に DTP に送信されます。https://docs.parasoft.com にある SOAtest ユーザーガイドの「アプリケーションカバレッジ」セクションを参照してください。

カバレッジレポートの作成と DTP へのデータのアップロード

jtestcov または jtestcli コマンドを使用してカバレッジレポートを作成し、DTP にデータをアップロードできます。jtestcov コマンドラインオプションの詳細は、「jtestcov のコマンドラインオプション」を参照してください。

CAM とともに Jtest を使用する場合、3 つのタイプのカバレッジレポートを生成できます。

静的カバレッジおよび実行時カバレッジレポート: マージされた静的カバレッジ (ソースコード情報を含む) および実行時カバレッジが含まれています。このレポートを作成するには、-runtimeCoverage および -staticCoverage スイッチを指定して jtestcli を実行するか、-runtime および -static をスイッチを指定して jtestcov を実行します。
アプリケーションカバレッジレポート: アプリケーションのバイナリおよび実行時カバレッジをスキャンすることで生成される静的カバレッジレポートです。このレポートを作成するには、-app および -runtime スイッチを指定して jtestcov を実行します。
実行時カバレッジレポート: 実行時カバレッジおよび実行されたクラスに関する一般的な情報だけが含まれる簡易的なアプリレポートです。カバーされた行以外のクラス構造の詳細は含まれません。既存のアプリケーションまたは静的カバレッジベースのデータが DTP に存在する場合、このレポートを参照できます。このレポートを作成するには、-runtime スイッチを指定して jtestcov を実行します。

カバレッジレポートを作成し、DTP にデータをアップロードするには、次の操作を行います。

Jtest で DTP、スコープ、作成者が適切に設定されていることを確認します。「DTP への接続」、「DTP への結果の送信とソースコードのパブリッシュ」、「設定」を参照してください。
適切にカバレッジデータをマージするには、jtestcov.properties ファイル (<INSTALL_DIR>/integration/coverage にあります) または jtestcli.properties ファイルで以下の設定を行います。
- report.coverage.images - DTP でカバレッジイメージを作成するために使用するタグのセットを指定します。カバレッジイメージは、同じビルド ID を持つ複数の実行のカバレッジデータを集約する際に一意の識別子となります。DTP は、1 レポートにつき最大 3 つまでのカバレッジイメージをサポートします。
- session.tag - 同じビルドの個々のテスト実行を区別する一意の識別子を指定します。
- build.id - 結果にラベル付けするためのビルド識別子を指定します。ビルドごとに固有の値を使用することも、特定のビルドで実行される複数のテストセッションで同じ値を使用することもできます。
jtestcli を使用する場合、実行時カバレッジファイルおよび静的カバレッジファイルを同じマシンにコピーし、次のスイッチを指定して jtestcli を実行します。
- -runtimeCoverage: CAM でダウンロードする実行時カバレッジへのパスを指定します (詳細については DTP のマニュアルの「Coverage Agent Manager (CAM)」セクションを参照)。単一のテストセッションのカバレッジ情報を保存した個々の .data ファイルへのパスを指定することも、複数のテストセッションの .data ファイルを含むフォルダーへのパスを指定することもできます。
- -staticCoverage: 静的カバレッジファイルへのパスを指定します (「モニターパッケージの生成」を参照)。
- -config: カバレッジデータをマージするために実行する必要のある Calculate Application Coverage テストコンフィギュレーションの URL を指定します。
- -publish: マージされたカバレッジを DTP に送信します。
  jtestcli -staticcoverage [path to static_coverage.xml file] -runtimecoverage [path/dir] -config "builtin://Calculate Application Coverage" -publish
  これによって、coverage.xml ファイルに実行時カバレッジデータを書き込みできるよう、静的カバレッジデータだけでなく、テスト実行時に生成される実行時データカバレッジにも Jtest がアクセスできるようになります。
jtestcov を使用する場合、以下のスイッチを指定して jtestcov を実行します。
- -app: テスト対象アプリケーションのディレクトリまたはアーカイブファイルへのパスを指定します。
- -runtime: CAM でダウンロードする実行時カバレッジへのパスを指定します (詳細については DTP のマニュアルの「Coverage Agent Manager (CAM)」セクションを参照)。単一のテストセッションのカバレッジ情報を保存した個々の .data ファイルへのパスを指定することも、複数のテストセッションの .data ファイルを含むフォルダーへのパスを指定することもできます。
- -static: 静的カバレッジファイルへのパスを指定します (「モニターパッケージの生成」を参照)。
- -publish: マージされたカバレッジを DTP に送信します。
  例 1: 実行時データおよびモニターからの静的カバレッジに基づいてレポートを生成する
  java -jar jtestcov.jar -static [path to static_coverage.xml file] -runtime [path/dir] -publish -settings [path to jtestcov.properties]
  例 2: 実行時データおよびアプリケーションバイナリからのカバレッジに基づいてレポートを生成する
  java -jar jtestcov.jar -app [path/dir] -runtime [path/dir] -publish -settings [path to jtestcov.properties]
  例 3: 実行時データに基づいてレポートを生成する
  java -jar jtestcov.jar -runtime [path/dir] -publish -settings [path to jtestcov.properties]
以前に生成された実行時カバレッジレポートをマージするには、jtestcov merge コマンドを実行します。2 つ以上のレポートをマージするには、次のコマンドを実行します。
java -jar jtestcov.jar merge -coverage <REPORT_FILE> -coverage <REPORT_FILE> [-coverage <REPORT_FILE>] [-report <REPORT_DIR>]
- -coverage <REPORT_FILE>: マージして DTP にパブリッシュする 1 つ以上の入力カバレッジレポートを指定します。
- -report <REPORT_DIR>: (任意) 指定されたフォルダーに xml カバレッジレポートを生成します。デフォルトでは、レポートは .coverage/reports フォルダーに保存されます。

SOAtest を使用する場合、テスト実行時に静的カバレッジおよび実行時カバレッジデータがマージされ、DTP に送信されます。https://docs.parasoft.com にある SOAtest ユーザーガイドの「アプリケーションカバレッジ」セクションを参照してください。

DTP でのカバレッジの参照

DTP のカバレッジエクスプローラーを使用して、テスト実行時のアプリケーションカバレッジを参照できます。カバレッジ情報の参照についての詳細は、https://docs.parasoft.com にある DTP ユーザーガイドを参照してください。

既知の制限事項

1 つの Web アプリケーションに複数のユーザーが同時にアクセスした場合、複数のユーザーのカバレッジデータが混在する場合があります。個々のユーザーに正しくカバレッジが関連付けられるようにするには、マルチユーザーモードを有効にします (「カバレッジエージェントの構成」を参照)。
マルチユーザーモードを有効にするには、HTTP ヘッダーでユーザー固有の情報を提供するため、HTTP または HTTPS プロトコルが必要です。
マルチユーザーモードでは、同じ Web アプリケーションにアクセスしている他のユーザーの余分なカバレッジ情報が、「デフォルト」ユーザー (ID が指定されていないユーザー) に集約される場合があります。
マルチユーザーモードでは、マルチユーザーアプリケーションから収集されたカバレッジを個々のユーザーに割り当てる機能には制約があります。子スレッドのカバレッジデータは、実際にアプリケーションにアクセスしたユーザーではなく、「デフォルト」ユーザーに割り当てられます。
マルチユーザーモードでは、Jacoco エンジンを使用したカバレッジの収集はサポートされていません。
Web アプリケーションの初期化から収集されたカバレッジデータは、特定のユーザーではなく「デフォルト」ユーザーに割り当てられます。

jtestcov のコマンドラインオプション

このセクションは、jtestcov のコマンドラインオプションの一覧です。

coverage

デフォルトのコマンドです。アプリケーションおよび実行時カバレッジデータをスキャンしてカバレッジレポートを生成します。レポートを生成するには、次のコマンドを実行します。

java -jar jtestcov.jar coverage [-app <APP_LOCATION> | -static <BASE_COVERAGE_REPORT_FILE>] -runtime <RUNTIME_COVERAGE_LOCATION> [-report <REPORT_DIR>] [-deleteruntime]

-app <APP_LOCATION>

テスト対象アプリケーション (AUT) のディレクトリまたはアーカイブファイル (war、ear、jar、zip) の場所を指定します。

-static <BASE_COVERAGE_REPORT_FILE>

AUT のカバレッジベースを含む XML カバレッジレポートファイルを指定します。

-runtime <RUNTIME_COVERAGE_LOCATION>

AUT に対してテストを実行したときに生成された実行時カバレッジディレクトリの場所を指定します。

-report <REPORT_DIR>

指定されたフォルダーに XML カバレッジレポートを生成します。任意パラメーターです。デフォルトでは、レポートは .coverage/reports フォルダーに保存されます。

-deleteruntime

カバレッジ XML レポートの生成に使用した実行時カバレッジデータファイルを削除します。
このパラメーターが指定されている場合、レポート作成後に実行時カバレッジデータファイルが削除されます。

impacted

アプリケーションをスキャンし、ベースラインカバレッジレポートを解析して再実行が必要なテストを検出します。影響を受けるテストの LST ファイルを生成するには、次のコマンドを実行します。

java -jar jtestcov.jar impacted -app <APP_LOCATION> -baseline <BASELINE_COVERAGE_REPORT FILE> [-report <LST_FILE_DIR>]

-app <APP_LOCATION>

テスト対象アプリケーション (AUT) のディレクトリまたはアーカイブファイル (war、ear、jar、zip) の場所を指定します。

-baseline <BASELINE_COVERAGE_REPORT_FILE>

ベースラインとして使用する XML カバレッジレポートを指定します。

-report <LST_FILE_DIR>

指定された場所に LST ファイルを生成します。LST ファイルがすでに存在する場合、上書きされます。任意パラメーターです。デフォルトでは、LST ファイルは .coverage/lsts フォルダーに保存されます。

merge

以前に生成された実行時カバレッジレポートをマージします。2 つ以上のレポートをマージするには、次のコマンドを実行します。

java -jar jtestcov.jar merge -coverage <REPORT_FILE> -coverage <REPORT_FILE> [-coverage <REPORT_FILE>] [-report <REPORT_DIR>]

-coverage <REPORT_FILE>

マージして DTP にパブリッシュする 1 つ以上のカバレッジ XML レポートを指定します。

-report <REPORT_DIR>

指定されたフォルダーに XML カバレッジレポートを生成します。任意パラメーターです。デフォルトでは、レポートは .coverage/reports フォルダーに保存されます。

help

jtestcov ヘルプを表示します。

その他の引数

-include <PATTERN>
-exclude <PATTERN>

AUT のスキャン時に含める/除外する要素のパターンを指定します。任意パラメーターです。デフォルトでは、すべての要素が対象になります。

-publish

生成されたレポートを DTP Server にアップロードします。(設定パターン: report.dtp.publish=true)

-settings <SETTINGS_FILE>

ファイルからカスタム設定を読み取ります。<SETTINGS_FILE> は、<KEY=VALUE> 形式のエントリを含む既存の設定ファイル (.properties) である必要があります。

-property

カスタム設定エントリを指定します。-property を複数回使用できます (複数のエントリに同じキーが含まれている場合、最初に指定されたエントリが後のすべてのエントリを上書きします)。

-showdetails

出力の冗長性を上げます。
(設定パターン: console.verbosity.level=high)

jtestcov 終了コード

プロセスは、次の終了コードで終了する場合があります。

コード	意味
1	プロセスは例外で終了しました。エラーログを確認してください。

はじめに

前提条件

プロセスの概要

カバレッジ収集のためのテスト対象アプリケーション (AUT) の構成

モニター パッケージの生成

カバレッジ エージェントの構成

テスト対象アプリケーション (AUT) へのカバレッジ エージェントのアタッチ

HTTPS 経由での Coverage Agent への接続

テストを実行してランタイム カバレッジを収集する

DTP への結果のアップロード

カバレッジ レポートの作成と DTP へのデータのアップロード

DTP でのカバレッジの参照

既知の制限事項

jtestcov のコマンド ライン オプション

coverage

-app <APP_LOCATION>

-static <BASE_COVERAGE_REPORT_FILE>

-runtime <RUNTIME_COVERAGE_LOCATION>

-report <REPORT_DIR>

-deleteruntime

impacted

-app <APP_LOCATION>

-baseline <BASELINE_COVERAGE_REPORT_FILE>

-report <LST_FILE_DIR>

merge

-coverage <REPORT_FILE>

-report <REPORT_DIR>

help

その他の引数

-include <PATTERN>-exclude <PATTERN>

-publish

-settings <SETTINGS_FILE>

-property

-showdetails

jtestcov 終了コード

モニターパッケージの生成

カバレッジエージェントの構成

テスト対象アプリケーション (AUT) へのカバレッジエージェントのアタッチ

テストを実行してランタイムカバレッジを収集する

カバレッジレポートの作成と DTP へのデータのアップロード

jtestcov のコマンドラインオプション

-include <PATTERN>
-exclude <PATTERN>