CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.CollectingTestListener |
すべてのテスト結果を収集する ITestInvocationListener。
このオブジェクトで使用されるデータ構造はスレッドセーフですが、ITestInvocationListener コールバックは正しい順序で呼び出す必要があります。
概要
パブリック コンストラクタ | |
|---|---|
CollectingTestListener()
|
|
パブリック メソッド | |
|---|---|
IBuildInfo
|
getBuildInfo()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
|
TestRunResult
|
getCurrentRunResults()
現在のテスト実行の結果を取得します。 |
int
|
getExpectedTests()
予想されるテスト数を返します。 |
IInvocationContext
|
getInvocationContext()
|
|
getMergedTestRunResults()
異なる試行のすべての実行の結果のマージされたコレクションを返します。 |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
結果に関連付けられたモジュールの |
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()
|
|
getRunResults()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
|
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
1 回の試行に対して |
int
|
getTestRunAttemptCount(String testRunName)
指定されたテスト実行名に対する試行回数を返します。 |
|
getTestRunAttempts(String testRunName)
指定されたテスト実行の |
|
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)
ログとテストケースとの関連性が強く求められる場合がありますが、
直線の |
void
|
setBuildInfo(IBuildInfo buildInfo)
<ph type="x-smartling-placeholder"></ph> このメソッドは非推奨です。 テストには不要になりました。 |
void
|
setDisable(boolean isDisabled)
オブジェクトを無効にするかどうかを設定します。 |
void
|
setMergeStrategy(MergeStrategy strategy)
結果の統合時に使用する |
void
|
testAssumptionFailure(TestDescription test, String trace)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます |
void
|
testEnded(TestDescription test, long endTime,
終了時間を指定できる |
void
|
testEnded(TestDescription test,
個々のテストケースの実行終了を報告します。 |
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,
テスト実行の終了をレポートします。 |
void
|
testRunFailed(FailureDescription failure)
|
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)
|
void
|
testStarted(TestDescription test)
個々のテストケースの開始を報告します。 |
保護されたメソッド | |
|---|---|
final
void
|
clearModuleLogFiles()
モジュール ファイルをクリーンアップして、モジュール ファイルを長時間保持しないようにします。 |
final
void
|
clearResultsForName(String testRunName)
指定した実行名の結果を消去できます。 |
void
|
setIsAggregrateMetrics(boolean aggregate)
[指標の集計] を切り替えオプション |
パブリック コンストラクタ
CollectingTestListener
public CollectingTestListener ()
パブリック メソッド
getBuildInfo
public IBuildInfo getBuildInfo ()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
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
publicgetMergedTestRunResults ()
異なる試行のすべての実行の結果のマージされたコレクションを返します。
複数の結果がある場合、各テスト実行は最新のテスト結果とマージされます。 以前の実行のテスト結果を上書きする。テスト実行は試行番号順に並べられます。
同じ試行の指標は、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
publicgetRunResults ()
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
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
publicgetTestRunAttempts (String testRunName)
指定されたテスト実行の TestRunResult に対するすべての試行を取得します。
| パラメータ | |
|---|---|
testRunName |
String: {testRunStarted(String, int) によって指定された名前。 |
| 戻り値 | |
|---|---|
|
特定のテスト実行のすべての TestRunResult を試行回数で並べ替えます。 |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
指定された試行のすべての結果を取得します。
| パラメータ | |
|---|---|
attempt |
int: 結果を取得する試行。 |
| 戻り値 | |
|---|---|
|
特定の試行のすべての TestRunResult。 |
getTestRunNames
publicgetTestRunNames ()
すべてのテスト実行のすべての名前を返します。
これらのテスト実行は、異なる試行で複数回実行された可能性があります。
| 戻り値 | |
|---|---|
|
|
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)
<ph type="x-smartling-placeholder"></ph>
このメソッドは非推奨です。
テストには不要になりました。
ビルド情報を設定します。テスト目的でのみ使用してください。
| パラメータ | |
|---|---|
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 |