XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

JUnit の結果を、Ant の XMLJUnitResultFormatter と一貫性のある形式で XML ファイルに書き込みます。

テスト実行ごとに個別の XML ファイルを作成します。

概要

パブリック コンストラクタ

XmlTestRunListener()

パブリック メソッド

void addSystemError(String systemError)

システム エラー メッセージを追加します。

TestRunResult getRunResult()

TestRunResult を返します。
String getSystemError()

「system-err」要素の XML ファイルに書き込まれるシステム エラー メッセージを返します。
void setHostName(String hostName)
void setReportDir(File file)

使用するレポート ファイルを設定します。
void testAssumptionFailure(TestIdentifier test, String trace)

アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます。
void testEnded(TestIdentifier test, testMetrics)

個々のテストケースの実行終了を報告します。
void testFailed(TestIdentifier test, String trace)

個々のテストケースの失敗を報告します。
void testIgnored(TestIdentifier test)

テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付いていることが原因です。
void testRunEnded(long elapsedTime, runMetrics)

テスト実行の終了を報告します。
void testRunFailed(String errorMessage)

致命的なエラーのため、レポートのテスト実行を完了できませんでした。

void testRunStarted(String runName, int numTests)

テスト実行の開始を報告します。
void testRunStopped(long elapsedTime)

ユーザーのリクエストにより、レポートのテスト実行が完了前に停止しました。
void testStarted(TestIdentifier test)

個々のテストケースの開始を報告します。

保護されたメソッド

getPropertiesAttributes()

テストレポートに含めるプロパティ属性を Key-Value ペアとして取得します。
File getResultFile(File reportDir)

レポートが作成される ERROR(/File) を作成します。
String getTestName(TestIdentifier testId)
String getTestSuiteName()

パブリック コンストラクタ

XmlTestRunListener

public XmlTestRunListener ()

パブリック メソッド

addSystemError

public void addSystemError (String systemError)

システム エラー メッセージを追加します。

パラメータ
systemError String

getRunResult

public TestRunResult getRunResult ()

TestRunResult を返します

戻り値
TestRunResult テスト実行の結果。

getSystemError

public String getSystemError ()

「system-err」要素の XML ファイルに書き込まれるシステム エラー メッセージを返します。これが空の文字列を返すと、要素は作成されません。

戻り値
String

setHostName

public void setHostName (String hostName)

パラメータ
hostName String

setReportDir

public void setReportDir (File file)

使用するレポート ファイルを設定します。

パラメータ
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます

パラメータ
test TestIdentifier: テストを識別します
trace String: 失敗のスタック トレース

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestIdentifier, String) が呼び出されなかった場合、このテストは合格です。テストケースの実行中に生成された Key-Value 指標も返します。

パラメータ
test TestIdentifier: テストを識別します
testMetrics : android.app.Instrumentation#sendStatus によるテストケースの実行中に生成された指標の ERROR(/Map)。同じキーを複数回出力しない限り、挿入順序は保持されます。IInstrumentationResultParser.StatusKeys で定義された標準キーは、この Map から除外されます。Ddmlib は、IInstrumentationResultParser.StatusKeys で定義された追加のテスト指標を追加する場合があります。

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

個々のテストケースの失敗を報告します。

testStarted と testEnded の間に呼び出されます。

パラメータ
test TestIdentifier: テストを識別します
trace String: 失敗のスタック トレース

testIgnored

public void testIgnored (TestIdentifier test)

テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付けられていることが原因です。

パラメータ
test TestIdentifier: テストを識別します

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了を報告します。

パラメータ
elapsedTime long: デバイスが報告した経過時間（ミリ秒単位）
runMetrics : android.app.Instrumentation#addResults によるテストケースの実行中に生成された指標の ERROR(/Map)。同じキーを複数回出力しない限り、挿入順序は保持されます。IInstrumentationResultParser.StatusKeys で定義された標準キーは、この Map から除外されます。Ddmlib は、IInstrumentationResultParser.StatusKeys で定義された追加のテスト指標を追加する場合があります。

testRunFailed

public void testRunFailed (String errorMessage)

致命的なエラーのため、レポートのテスト実行を完了できませんでした。

パラメータ
errorMessage String: 実行の失敗理由を説明する String。

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

テスト実行の開始を報告します。

パラメータ
runName String: テスト実行名
numTests int: テスト実行のテストの合計数

testRunStopped

public void testRunStopped (long elapsedTime)

ユーザーのリクエストにより、レポートのテスト実行が完了前に停止しました。

パラメータ
elapsedTime long: デバイスが報告した経過時間（ミリ秒単位）

testStarted

public void testStarted (TestIdentifier test)

個々のテストケースの開始を報告します。

パラメータ
test TestIdentifier: テストを識別します

保護されたメソッド

getPropertiesAttributes

protected  getPropertiesAttributes ()

テストレポートに含めるプロパティ属性を Key-Value ペアとして取得します。

戻り値

getResultFile

protected File getResultFile (File reportDir)

レポートの作成先となる ERROR(/File) を作成します。

パラメータ
reportDir File: レポートのルート ディレクトリ。
戻り値
File ファイル
例外
IOException

getTestName

protected String getTestName (TestIdentifier testId)

パラメータ
testId TestIdentifier

戻り値
String

getTestSuiteName

protected String getTestSuiteName ()

戻り値
String