CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener

すべてのテスト結果を収集する ITestInvocationListener。

このオブジェクトで使用されるデータ構造はスレッドセーフですが、ITestInvocationListener コールバックは正しい順序で呼び出す必要があります。

概要

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

CollectingTestListener()

パブリック メソッド

IBuildInfo getBuildInfo()

このメソッドは非推奨です。 getInvocationContext() の IBuildInfo に依存します。

TestRunResult getCurrentRunResults()

現在のテスト実行の結果を取得します。

int getExpectedTests()

予想されるテスト数を返します。

IInvocationContext getInvocationContext()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) を介して報告された呼び出しコンテキストを返します。

getMergedTestRunResults()

異なる試行のすべての実行の結果のマージされたコレクションを返します。

IInvocationContext getModuleContextForRunResult(String testRunName)

結果に関連付けられたモジュールの IInvocationContext を返します。

MultiMap<String, LogFile> getModuleLogFiles()

モジュールに関連付けられているすべてのログファイルを含むマップのコピーを返します。

MultiMap<String, LogFile> getNonAssociatedLogFiles()

テスト実行またはログに関連付けられていないログファイルをすべて含むマップのコピーを返します。 説明します。

int getNumAllFailedTestRuns()

失敗状態のテスト実行の合計数を返します

int getNumAllFailedTests()

不合格状態のテストの合計数を返します（不合格のみ、前提条件の不合格は不合格となり、 カウントされます）。

int getNumTestsInState(TestStatus status)

この実行について、指定された状態のテストの数を返します。

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

古いステータス タイプとの互換性のため

int getNumTotalTests()

すべての実行の完全なテストの合計数を返します。

IBuildInfo getPrimaryBuildInfo()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) を介して報告されたプライマリ ビルド情報を返します。

getRunResults()

このメソッドは非推奨です。 getMergedTestRunResults() を使用する

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

1 回の試行に対して TestRunResult を返します。

int getTestRunAttemptCount(String testRunName)

指定されたテスト実行名に対する試行回数を返します。

getTestRunAttempts(String testRunName)

指定されたテスト実行の TestRunResult に対するすべての試行を取得します。

getTestRunForAttempts(int attempt)

指定された試行のすべての結果を取得します。

getTestRunNames()

すべてのテスト実行のすべての名前を返します。

boolean hasFailedTests()

呼び出しで不合格になったテストまたは仮定テストが失敗したかどうかを返します。

boolean hasTestRunResultsForName(String testRunName)

指定されたテスト実行名に結果があるかどうかを返します。

void invocationEnded(long elapsedTime)

正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。

void invocationFailed(Throwable cause)

エラー条件により不完全な呼び出しを報告します。

void invocationSkipped(SkipReason reason)

呼び出しをスキップ済みとして報告する

void invocationStarted(IInvocationContext context)

テスト呼び出しの開始を報告します。

boolean isDisabled()

オブジェクト全体が無効になっている場合は true を返します（セットアップとティアダウンの両方をスキップ）。

void logAssociation(String dataName, LogFile logFile)

ログとテストケースとの関連性が強く求められる場合がありますが、 直線の testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) です。 できません。

void setBuildInfo(IBuildInfo buildInfo)

このメソッドは非推奨です。 テストには不要になりました。

void setDisable(boolean isDisabled)

オブジェクトを無効にするかどうかを設定します。

void setMergeStrategy(MergeStrategy strategy)

結果の統合時に使用する MergeStrategy を設定します。

void testAssumptionFailure(TestDescription test, String trace)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

void testAssumptionFailure(TestDescription test, FailureDescription failure)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

void testEnded(TestDescription test, long endTime, testMetrics)

終了時間を指定できる ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) の代替 直接渡されます。

void testEnded(TestDescription test, testMetrics)

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

void testFailed(TestDescription test, FailureDescription failure)

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

void testFailed(TestDescription test, String trace)

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

void testIgnored(TestDescription test)

テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。

void testModuleEnded()

モジュール実行の終了をレポートします。

void testModuleStarted(IInvocationContext moduleContext)

実行中のモジュールの開始を報告します。

void testRunEnded(long elapsedTime, runMetrics)

テスト実行の終了をレポートします。

void testRunFailed(FailureDescription failure)

FailureDescription で説明されているエラーのため、テスト実行を完了できなかったことをレポートします。

void testRunFailed(String errorMessage)

致命的なエラーのため、テスト実行を完了できなかったことをレポートします。

void testRunStarted(String name, int numTests, int attemptNumber)

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

void testRunStarted(String name, int numTests)

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

void testRunStarted(String name, int numTests, int attemptNumber, long startTime)

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

void testRunStopped(long elapsedTime)

ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。

void testSkipped(TestDescription test, SkipReason reason)

テストがスキップされ、通常は予期されない理由でテストが実行されなかった場合に呼び出されます。

void testStarted(TestDescription test, long startTime)

testStarted(com.android.tradefed.result.TestDescription) に代わるもので、テストがいつ実行されたかも指定します。 開始され、正確な測定のために ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) と組み合わせて使用されます。

void testStarted(TestDescription test)

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

保護されたメソッド

final void clearModuleLogFiles()

モジュール ファイルをクリーンアップして、モジュール ファイルを長時間保持しないようにします。

final void clearResultsForName(String testRunName)

指定した実行名の結果を消去できます。

void setIsAggregrateMetrics(boolean aggregate)

[指標の集計] を切り替えオプション

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

CollectingTestListener

public CollectingTestListener ()

パブリック メソッド

getBuildInfo

public IBuildInfo getBuildInfo ()

このメソッドは非推奨です。
getInvocationContext() の IBuildInfo に依存します。

ビルド情報を返します。

戻り値
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

現在のテスト実行の結果を取得します。

すべての結果が表示されない場合があります。必要に応じて、TestRunResult.isRunComplete() と (@link TestRunResult#isRunFailure()}、またはその両方) の値をテストすることをおすすめします。 結果を処理する必要があります

戻り値
TestRunResult 前回のテスト実行中に収集されたデータを表す TestRunResult

getExpectTests

public int getExpectedTests ()

予想されるテスト数を返します。次の場合は getNumTotalTests() と異なる可能性があります。 一部のテストが実行されませんでした。

戻り値
int

getInvocationContext

public IInvocationContext getInvocationContext ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) を介して報告された呼び出しコンテキストを返します。

戻り値
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

異なる試行のすべての実行の結果のマージされたコレクションを返します。

複数の結果がある場合、各テスト実行は最新のテスト結果とマージされます。 以前の実行のテスト結果を上書きする。テスト実行は試行番号順に並べられます。

同じ試行の指標は、aggregate-metrics で設定された設定に基づいて統合されます。最後の指標は、最後の試行の指標になります。

戻り値

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

結果に関連付けられたモジュールの IInvocationContext を返します。

パラメータ
testRunName String: {testRunStarted(String, int) によって指定された名前。
戻り値
IInvocationContext 指定されたテスト実行名 null のモジュールの IInvocationContext 一致する結果がない場合に表示されます。

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

モジュールに関連付けられているすべてのログファイルを含むマップのコピーを返します。

戻り値
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

テスト実行またはログに関連付けられていないログファイルをすべて含むマップのコピーを返します。 説明します。

戻り値
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

失敗状態のテスト実行の合計数を返します

戻り値
int

getNumAllFailedTests

public int getNumAllFailedTests ()

不合格状態のテストの合計数を返します（不合格のみ、前提条件の不合格は不合格となり、 カウントされます）。

戻り値
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

この実行について、指定された状態のテストの数を返します。

パラメータ
status TestStatus

戻り値
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

古いステータス タイプとの互換性のため

パラメータ
ddmlibStatus TestResult.TestStatus

戻り値
int

getNumTotalTests

public int getNumTotalTests ()

すべての実行の完全なテストの合計数を返します。

戻り値
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext) を介して報告されたプライマリ ビルド情報を返します。プライマリ ビルドとは、最初の 実行構成のビルド プロバイダ。コンテキストがない場合（ あります。

戻り値
IBuildInfo

getRunResults

public  getRunResults ()

このメソッドは非推奨です。
getMergedTestRunResults() を使用する

すべてのテスト実行の結果を返します。

戻り値

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

1 回の試行に対して TestRunResult を返します。

パラメータ
testRunName String: {testRunStarted(String, int) によって指定された名前。
attempt int: 試行 ID。
戻り値
TestRunResult 指定の名前と試行 ID の TestRunResult。存在する場合は null。 存在しません。

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

指定されたテスト実行名に対する試行回数を返します。

パラメータ
testRunName String: {testRunStarted(String, int) によって指定された名前。
戻り値
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

指定されたテスト実行の TestRunResult に対するすべての試行を取得します。

パラメータ
testRunName String: {testRunStarted(String, int) によって指定された名前。
戻り値
特定のテスト実行のすべての TestRunResult を試行回数で並べ替えます。

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

指定された試行のすべての結果を取得します。

パラメータ
attempt int: 結果を取得する試行。
戻り値
特定の試行のすべての TestRunResult。

getTestRunNames

public  getTestRunNames ()

すべてのテスト実行のすべての名前を返します。

これらのテスト実行は、異なる試行で複数回実行された可能性があります。

戻り値

hasFailedTests

public boolean hasFailedTests ()

呼び出しで不合格になったテストまたは仮定テストが失敗したかどうかを返します。

戻り値
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

指定されたテスト実行名に結果があるかどうかを返します。

パラメータ
testRunName String: {testRunStarted(String, int) によって指定された名前。
戻り値
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

正常に終了したか、なんらかのエラーが発生したために呼び出しが終了したことを報告する あります。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
elapsedTime long: 呼び出しの経過時間（ミリ秒）

invocationFailed

public void invocationFailed (Throwable cause)

エラー条件により不完全な呼び出しを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
cause Throwable: 失敗の Throwable 原因

invocationSkipped

public void invocationSkipped (SkipReason reason)

呼び出しをスキップ済みとして報告する

パラメータ
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

テスト呼び出しの開始を報告します。

TradeFederation フレームワークによって自動的に呼び出されます。レポーターはオーバーライドする必要があります 複数のデバイスのレポートに対応できます。

パラメータ
context IInvocationContext: 呼び出しに関する情報

isDisabled

public boolean isDisabled ()

オブジェクト全体が無効になっている場合は true を返します（セットアップとティアダウンの両方をスキップ）。それ以外の場合は False です。

戻り値
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

ログとテストケースとの関連性が強く求められる場合がありますが、 直線の testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) です。 できません。したがって、このコールバックを使用すると、 明示的に指定することもできます。

パラメータ
dataName String: データの名前
logFile LogFile: 以前にログに記録された LogFile に関連付ける必要があります。 テストケースです

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

このメソッドは非推奨です。
テストには不要になりました。

ビルド情報を設定します。テスト目的でのみ使用してください。

パラメータ
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

オブジェクトを無効にするかどうかを設定します。無効とはセットアップと破棄の両方のステップが スキップすべきですデフォルト状態で使用するオブジェクトをデフォルトで無効にするために コンストラクタがあります。

パラメータ
isDisabled boolean: オブジェクトを配置する状態。

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

結果の統合時に使用する MergeStrategy を設定します。

パラメータ
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

パラメータ
test TestDescription: テストを識別します。
trace String: 障害のスタック トレース

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます

パラメータ
test TestDescription: テストを識別します。
failure FailureDescription: エラーとそのコンテキストを記述する FailureDescription。

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

終了時間を指定できる ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) の代替 直接渡されます。testStarted(com.android.tradefed.result.TestDescription, long) と組み合わせて使用すると、正確に測定できます。

パラメータ
test TestDescription: テストを識別します。
endTime long: テストが終了した時刻（System.currentTimeMillis() で測定）
testMetrics : 出力された指標の ERROR(/Map)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

testFailed(TestDescription, FailureDescription) が呼び出されなかった場合、このテストは合格です。また、任意の Key-Value を返します。 テストケースの実行中に出力された可能性のある指標を示します。

パラメータ
test TestDescription: テストを識別します。
testMetrics : 出力された指標の ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

パラメータ
test TestDescription: テストを識別します。
failure FailureDescription: エラーとそのコンテキストを記述する FailureDescription。

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

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

パラメータ
test TestDescription: テストを識別します。
trace String: 障害のスタック トレース

testIgnored

public void testIgnored (TestDescription test)

テストが実行されないときに呼び出されます。通常はテストメソッドに org.junit.Ignore を使用します。

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

testModuleEnded

public void testModuleEnded ()

モジュール実行の終了をレポートします。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

実行中のモジュールの開始を報告します。このコールバックは testModuleEnded() に関連付けられており、シーケンスでは省略可能です。これは、Pod を使用する実行時にのみ スイートベースのランナーです。

パラメータ
moduleContext IInvocationContext: モジュールの IInvocationContext。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了をレポートします。修正: 2 つの Map<> は使用できないインターフェースが異なるため、 ここでは HashMap を使用する必要があります。

パラメータ
elapsedTime long: デバイスで報告された経過時間（ミリ秒単位）
runMetrics : Metric を使用してテスト実行の最後にレポートされる Key-Value ペア。

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription で説明されているエラーのため、テスト実行を完了できなかったことをレポートします。

パラメータ
failure FailureDescription: エラーとそのコンテキストを記述する FailureDescription。

testRunFailed

public void testRunFailed (String errorMessage)

致命的なエラーのため、テスト実行を完了できなかったことをレポートします。

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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

パラメータ
name String: テスト実行名
numTests int: テスト実行中のテストの合計数
attemptNumber int: 同じ runName の異なる試行を識別する注文番号 実行されるリソースのことですtryNumber の値は、0 から始まる番号で、毎回増分する必要があります。 発生します。例:テストは詳細に 3 回再試行され、合計 4 回試行される必要がある 同じ runName で実行され、AttemptNumber の値は 0 ～ 3 です。

testRunStarted

public void testRunStarted (String name, 
                int numTests)

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

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

パラメータ
name String: テスト実行名
numTests int: テスト実行中のテストの合計数
attemptNumber int: 同じ runName の異なる試行を識別する注文番号 実行されるリソースのことですtryNumber の値は 0 から始まり、 発生します。例:テストを細かく 3 回再試行する（合計 4 回の実行が必要） 同じ runName で指定され、trialNumber は 0 ～ 3 です。
startTime long: 実行の開始時刻（System.currentTimeMillis() で測定）

testRunStopped

public void testRunStopped (long elapsedTime)

ユーザー リクエストが原因で、テスト実行が完了前に停止したことを報告します。

TODO: 現在は使用されていないため、削除を検討してください

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

テストがスキップされ、通常は予期されない理由でテストが実行されなかった場合に呼び出されます。 これらのテストは、適切な実行を行うために再試行されます。

パラメータ
test TestDescription: テストを識別します。
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) に代わるもので、テストがいつ実行されたかも指定します。 開始され、正確な測定のために ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) と組み合わせて使用されます。

パラメータ
test TestDescription: テストを識別します。
startTime long: テストが開始された時刻（System.currentTimeMillis() で測定）

testStarted

public void testStarted (TestDescription test)

個々のテストケースの開始を報告します。古いインターフェースの場合は、可能な限り testStarted(com.android.tradefed.result.TestDescription) を使用してください。

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

保護されたメソッド

ClearModuleLogFiles

protected final void clearModuleLogFiles ()

モジュール ファイルをクリーンアップして、モジュール ファイルを長時間保持しないようにします。

ClearResultsForName

protected final void clearResultsForName (String testRunName)

指定した実行名の結果を消去できます。次のような一部の場合にのみ使用してください。 結果アグリゲータを指定します。

パラメータ
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

[指標の集計] を切り替えオプション

パラメータ
aggregate boolean