ResultAggregator

public class ResultAggregator
extends CollectingTestListener

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

---

実行された再試行戦略に基づいて、必要に応じて結果を集約する特別なフォワーダ。

概要

パブリック コンストラクタ
ResultAggregator( listeners, RetryStrategy strategy)

パブリック メソッド
void	cleanEventsFiles()
final void	forwardAggregatedInvocationLogs() 呼び出しレベルのログをすべて、詳細な結果をサポートしていない結果レポーターに転送します。
void	invocationEnded(long elapsedTime) 呼び出しが正常に終了したか、なんらかのエラー条件が原因で終了したかを報告します。
void	invocationFailed(FailureDescription failure)
void	invocationFailed(Throwable cause) エラー状態が原因で呼び出しが完了しなかったことを報告します。
void	invocationSkipped(SkipReason reason) 呼び出しをスキップされたものとして報告します
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	setLogSaver(ILogSaver logSaver)
void	setUpdatedReporting(boolean updatedReporting) 新しいレポートを設定します。
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	testFailed(TestDescription test, FailureDescription failure) 個々のテストケースの失敗を報告します。
void	testFailed(TestDescription test, String trace) 個々のテストケースの失敗を報告します。
void	testIgnored(TestDescription test) テストが実行されない場合に呼び出されます（通常は、テストメソッドに org.junit.Ignore がアノテーションされているため）。
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
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 testCount, int attemptNumber, long startTime) テスト実行の開始を報告します。
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)) と組み合わせて正確な測定を行います。

保護されたメソッド
File[]	getEventsLogs()

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

ResultAggregator

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

パラメータ
listeners
strategy	RetryStrategy

パブリック メソッド

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

詳細な結果をサポートしていない結果レポーターに、呼び出しレベルのログをすべて転送します。

invocationEnded

public void invocationEnded (long elapsedTime)

呼び出しが正常に終了したか、なんらかのエラー条件が原因で終了したかを報告します。

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

パラメータ
elapsedTime	long: 呼び出しの所要時間（ミリ秒単位）

invocationFailed

public void invocationFailed (FailureDescription failure)

パラメータ
failure	FailureDescription

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: 呼び出しに関する情報

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。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

パラメータ
logSaver	ILogSaver

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

新しいレポートを設定します。

パラメータ
updatedReporting	boolean

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)

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: テストを識別します。

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

パラメータ
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

パラメータ
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testModuleEnded

public void testModuleEnded ()

モジュールの実行の終了を報告します。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

パラメータ
elapsedTime	long: デバイスが報告した経過時間（ミリ秒単位）
runMetrics	: テスト実行の終了時に報告される 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 testCount, 
                int attemptNumber, 
                long startTime)

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

パラメータ
name	String: テスト実行名
testCount	int: テスト実行のテスト数の合計
attemptNumber	int: オーダー番号。同じ runName を複数回実行する際の試行を識別します。attemptNumber は 0 から始まり、新しい実行が行われるたびにインクリメントされます。たとえば、テストが 3 回きめ細かく再試行された場合、同じ runName で合計 4 回の実行が行われ、attemptNumber は 0 ～ 3 になります。
startTime	long: 実行が開始された時刻（System.currentTimeMillis() で測定）

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() で測定）

保護されたメソッド

getEventsLogs

protected File[] getEventsLogs ()

戻り値
File[]