CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener

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

既知の直接サブクラス

ConsoleResultReporter 、 EmailResultReporter 、 JsonHttpTestResultReporter 、 MetricsXMLResultReporter 、 ModuleListener 、 ShardListener 、 SuiteResultReporter 、 XmlResultReporter

ConsoleResultReporter	テスト結果をコンソールに出力する結果レポーター。
EmailResultReporter	テスト結果のメールを送信する単純な結果レポーター基本クラス。
JsonHttpTestResultReporter	テストメトリクスの結果とブランチ、デバイス情報をJSONに、POSTをHTTPサービスエンドポイントにエンコードする結果レポーター
MetricsXMLResultReporter	MetricsXMLResultReporterは、テストのinvocationEndedフェーズで、metrics-folderパラメーターによって指定されたフォルダー内のXMLファイルにテストメトリックと実行メトリックを書き込みます。
ModuleListener	結果のリストを収集するために、各モジュールの各`IRemoteTest`に接続されたリスナー。
ShardListener	呼び出しシャード（複数のリソースで並行して実行される呼び出し分割）から結果を収集し、それらを別のリスナーに転送する`ITestInvocationListener` 。
SuiteResultReporter	スイート呼び出し全体のテスト結果を収集し、最終結果を出力します。
XmlResultReporter	AntのXMLJUnitResultFormatterと一致する形式でJUnit結果をXMLファイルに書き込みます。

既知の間接サブクラス

DeviceUnavailEmailResultReporter 、 FailureEmailResultReporter 、 FormattedGeneratorReporter 、 InvocationFailureEmailResultReporter 、 TestFailureEmailResultReporter 、 XmlFormattedGeneratorReporter

DeviceUnavailEmailResultReporter	デバイスが利用できないという例外が原因で呼び出しが失敗したときに電子メールを送信する`EmailResultReporter` 。
FailureEmailResultReporter	テストの失敗または呼び出しの失敗が発生した場合に通知を送信する`EmailResultReporter` 。
FormattedGeneratorReporter	特定の形式でレポートを生成できるレポーター。
InvocationFailureEmailResultReporter	通知を呼び出しの失敗のみに制限することもできる`EmailResultReporter` 。
TestFailureEmailResultReporter	通知を制限して、失敗をテストするだけにすることもできる`EmailResultReporter` 。
XmlFormattedGeneratorReporter	スイートの結果をXML形式にする`FormattedGeneratorReporter`実装。

すべてのテスト結果を収集する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`を返します。
`int`	`getNumAllFailedTestRuns ()` 失敗状態のテスト実行の総数を返します
`int`	`getNumAllFailedTests ()` 失敗状態のテストの合計数を返します（失敗のみ。仮定の失敗はカウントされません）。
`int`	`getNumTestsInState (TestResult.TestStatus status)` この実行の特定の状態にあるテストの数を返します。
`int`	`getNumTotalTests ()` すべての実行の完全なテストの総数を返します。
`IBuildInfo`	`getPrimaryBuildInfo ()` `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`によって報告されたプライマリビルド情報を返し`invocationStarted(com.android.tradefed.invoker.IInvocationContext)` 。
	`getRunResults ()` このメソッドは非推奨です。 `getMergedTestRunResults()`使用します
`TestRunResult`	`getTestRunAtAttempt (String testRunName, int attempt)` 1回の試行に対して`TestRunResult`を返します。
`int`	`getTestRunAttemptCount (String testRunName)` 指定されたテスト実行名の試行回数を返します。
	`getTestRunAttempts (String testRunName)` 指定されたテスト実行の`TestRunResult`に対するすべての試行を取得します。
	`getTestRunNames ()` すべてのテスト実行のすべての名前を返します。
`boolean`	`hasFailedTests ()` 呼び出しに失敗したテストまたは仮定に失敗したテストがあったかどうかを返します。
`boolean`	`hasTestRunResultsForName (String testRunName)` 指定されたテスト実行名に結果があるかどうかを返します。
`void`	`invocationEnded (long elapsedTime)` 呼び出しが正常に終了したか、何らかのエラー条件が原因で終了したかを報告します。
`void`	`invocationFailed (Throwable cause)` 何らかのエラー条件が原因で、不完全な呼び出しを報告します。
`void`	`invocationStarted ( IInvocationContext context)` テスト呼び出しの開始を報告します。
`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`	`setMergeStrategy ( MergeStrategy strategy)` 結果をマージするときに使用する`MergeStrategy`を設定します。
`void`	`testAssumptionFailure ( TestDescription test, String trace)` アトミックテストがfalseの条件を想定していることを示すときに呼び出されます
`void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 、終了時刻を直接指定できます。
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` 個々のテストケースの実行終了を報告します。
`void`	`testFailed ( TestDescription test, String trace)` 個々のテストケースの失敗を報告します。
`void`	`testIgnored ( TestDescription test)` テストが実行されないときに呼び出されます。通常、テストメソッドにorg.junit.Ignoreのアノテーションが付けられているためです。
`void`	`testModuleEnded ()` モジュール実行の終了を報告します。
`void`	`testModuleStarted ( IInvocationContext moduleContext)` 実行中のモジュールの開始を報告します。
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` テスト実行の終了を報告します。
`void`	`testRunFailed (String errorMessage)` 致命的なエラーのため、レポートのテスト実行を完了できませんでした。
`void`	`testRunStarted (String name, int numTests, int attemptNumber)` テスト実行の開始を報告します。
`void`	`testRunStarted (String name, int numTests)` テスト実行の開始を報告します。
`void`	`testRunStopped (long elapsedTime)` ユーザーの要求により、レポートのテスト実行が完了する前に停止した。
`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)` 個々のテストケースの開始を報告します。

保護されたメソッド
`void`	`setIsAggregrateMetrics (boolean aggregate)` 「集計指標」オプションを切り替えます

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

CollectingTestListener

public CollectingTestListener ()

パブリックメソッド

getBuildInfo

public IBuildInfo getBuildInfo ()

このメソッドは非推奨です。
依存しているIBuildInfoからgetInvocationContext()

ビルド情報を返します。

戻り値
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

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

結果が完全でない場合があることに注意してください。結果を処理する前に、 TestRunResult#isRunComplete()または（@link TestRunResult＃isRunFailure（）}の値をTestRunResult#isRunComplete()にテストすることをお勧めします。

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

getExpectedTests

public int getExpectedTests ()

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

戻り値
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

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

戻り値
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

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

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

同じ試行のメトリックは、 aggregate-metricsによって設定された設定に基づいてマージされaggregate-metrics 。最終的なメトリックは、最後の試行のメトリックになります。

戻り値

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

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

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

戻り値
`IInvocationContext`	指定されたテスト実行名の結果がない場合、その名前のモジュールの`IInvocationContext`は`null`です。

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

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

戻り値
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

失敗状態のテストの合計数を返します（失敗のみ。仮定の失敗はカウントされません）。

戻り値
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

この実行の特定の状態にあるテストの数を返します。

パラメーター
`status`	`TestResult.TestStatus`

戻り値
`int`

getNumTotalTests

public int getNumTotalTests ()

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

戻り値
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)によって報告されたプライマリビルド情報を返しinvocationStarted(com.android.tradefed.invoker.IInvocationContext) 。プライマリビルドは、実行中の構成の最初のビルドプロバイダーによって返されるビルドです。コンテキストがない場合（ビルドするテストケースがない場合）はnullを返します。

戻り値
`IBuildInfo`

getRunResults

public  getRunResults ()

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

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

戻り値

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

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

パラメーター
`testRunName`	`String` ：{ `testRunStarted(String, int)`によって指定された名前。
`attempt`	`int` ：試行ID。

戻り値
`TestRunResult`	`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` 。試行順に並べられています。

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`可能な原因

invocationStarted

public void invocationStarted ( IInvocationContext context)

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

TradeFederationフレームワークによって自動的に呼び出されます。レポーターは、このメソッドをオーバーライドして、複数のデバイスのレポートをサポートする必要があります。

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

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`に記録され、テストケースに関連付ける必要がある`LogFile` 。

setBuildInfo

public void setBuildInfo ( IBuildInfo buildInfo)

このメソッドは非推奨です。
テストにはもう必要ありません。

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

パラメーター
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy ( MergeStrategy strategy)

結果をマージするときに使用するMergeStrategyを設定します。

パラメーター
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure ( TestDescription test, 
                String trace)

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

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

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, String)が呼び出されなかった場合、このテストはtestFailed(TestDescription, String)しました。また、テストケースの実行中に出力された可能性のあるキー/値メトリックを返します。

パラメーター
`test`	`TestDescription` ：テストを識別します
`testMetrics`	：発生したメトリックの`ERROR(/Map)`

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()関連付けられており、シーケンスではオプションです。これは、モジュールを使用する実行中にのみ使用されます： ITestSuiteベースのランナー。

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了を報告します。 FIXME：タイプの異なる2つのMap <>インターフェースを使用することはできないため、ここではHashMapを使用する必要があります。

パラメーター
`elapsedTime`	`long` ：デバイスがミリ秒で経過時間を報告しました
`runMetrics`	： `Metric`を使用したテスト実行の最後に報告されるキーと値のペア。

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の異なる試行を識別する注文番号。 attemptNumberのインデックスは0であり、新しい実行が発生するたびに増分する必要があります。たとえば、テストは3回細かく再試行され、同じrunNameの下で合計4つの実行があり、attemptNumberは0〜3です。

testRunStarted

public void testRunStarted (String name, 
                int numTests)

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

パラメーター
`name`	`String` ：テスト実行名
`numTests`	`int` ：テスト実行のテストの総数

testRunStopped

public void testRunStopped (long elapsedTime)

ユーザーの要求により、レポートのテスト実行が完了する前に停止しました。

TODO：現在使用されていません。削除することを検討してください

パラメーター
`elapsedTime`	`long` ：デバイスが経過時間をミリ秒単位で報告しました

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)使用してtestStarted(com.android.tradefed.result.TestDescription) 。

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

保護されたメソッド

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

「集計指標」オプションを切り替えます

パラメーター
`aggregate`	`boolean`