ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

既知の直接サブクラス FilteredResultForwarder 、 JarHostTest.HostTestListener 、 LogSaverResultForwarder 、 LogcatCrashResultForwarder 、 PythonBinaryHostTest.PythonForwarder 、 ResultAndLogForwarder 、 RetryResultForwarder 、 ShardMainResultForwarder 、 TestTimeoutEnforcer FilteredResultForwarder TestDescriptionの許可リストの報告のみを許可するResultForwarderのバリアント。 JarHostTest.HostTestListener testRunStarted() と testRunEnded() を除くすべてのイベントを組み込みリスナーに転送するラッパー リスナー。 LogSaverResultForwarder グローバル ファイル セーバーでログを保存するためのResultForwarder 。 LogcatCrashResultForwarder 特別なリスナー: 障害 (インスツルメンテーション プロセスのクラッシュ) が発生すると、logcat からクラッシュを抽出しようとし、それをテストに関連付けられた障害メッセージに追加します。 PythonBinaryHostTest.PythonForwarder 実行名をバイナリ名に置き換える結果フォワーダー。 ResultAndLogForwarder 結果およびログ イベントのフォワーダー。 RetryResultForwarder 常に特定の試行回数にプッシュするResultForwarderの拡張。 ShardMainResultForwarder 分割されたテスト呼び出しの結果を結合するResultForwarder 。 TestTimeoutEnforcer 特定のテスト ケースの実行時間をチェックし、特定のタイムアウトを超えた場合に失敗させることができるリスナー。

既知の間接サブクラス GranularRetriableTestWrapper.StartEndCollector 、 RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector 欠落している実行の開始と終了をキャッチするクラス ヘルパー。 RetryLogSaverResultForwarder 現在の試行の受け渡しも処理するフォワーダー。

---

呼び出し結果を他のリスナーのリストに転送するITestInvocationListener 。

まとめ

パブリック コンストラクター
ResultForwarder ( listeners) ResultForwarder ( listeners) ResultForwarderを作成します。
ResultForwarder ( ITestInvocationListener... listeners) ResultForwarderの代替変数 arg コンストラクター。

保護されたコンストラクター
ResultForwarder () 遅延リスナー設定でResultForwarderを作成します。

公開メソッド
TestSummary	getSummary () InvocationListener が要約を返すことを許可します。
void	invocationEnded (long elapsedTime) 呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。
void	invocationFailed ( FailureDescription failure) 何らかのエラー状態による不完全な呼び出しを報告します。
void	invocationFailed (Throwable cause) 何らかのエラー状態による不完全な呼び出しを報告します。
void	invocationStarted ( IInvocationContext context) テスト呼び出しの開始を報告します。
void	testAssumptionFailure ( TestDescription test, String trace) アトミック テストが false の条件を想定していることを示すフラグを立てたときに呼び出されます
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) アトミック テストが 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, FailureDescription failure) 個々のテスト ケースの失敗を報告します。
void	testFailed ( TestDescription test, String trace) 個々のテスト ケースの失敗を報告します。
void	testIgnored ( TestDescription test) 通常、テストメソッドに org.junit.Ignore の注釈が付けられているため、テストが実行されない場合に呼び出されます。
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) テスト呼び出しから関連するログまたはデバッグ データを提供します。
void	testModuleEnded () モジュール実行の終了を報告します。
void	testModuleStarted ( IInvocationContext moduleContext) 実行中のモジュールの開始を報告します。
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) テスト実行の終了を報告します。
void	testRunFailed ( FailureDescription failure) FailureDescriptionで説明されているエラーのため、レポートのテスト実行を完了できませんでした。
void	testRunFailed (String errorMessage) 致命的なエラーのため、レポートのテスト実行を完了できませんでした。
void	testRunStarted (String runName, int testCount, int attemptNumber) テスト実行の開始を報告します。
void	testRunStarted (String runName, int testCount) テスト実行の開始を報告します。
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) テスト実行の開始を報告します。
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) 個々のテスト ケースの開始を報告します。

保護されたメソッド
	getListeners () リスナーのリストを取得します。
void	setListeners ( ITestInvocationListener... listeners) 構築後にリスナーを設定します。
void	setListeners ( listeners) setListeners ( listeners) 構築後にリスナーを設定します。

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

ResultForwarder

public ResultForwarder ( listeners)

ResultForwarderを作成します。

パラメーター
listeners	: 結果を転送する実際のITestInvocationListener s

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarderの代替変数 arg コンストラクター。

パラメーター
listeners	ITestInvocationListener : 結果を転送する実際のITestInvocationListener s

保護されたコンストラクター

ResultForwarder

protected ResultForwarder ()

遅延リスナー設定でResultForwarderを作成します。サブクラスによる使用のみを目的としています。

公開メソッド

getSummary

public TestSummary getSummary ()

InvocationListener が要約を返すことを許可します。

戻り値
TestSummary	実行を要約するTestSummary 、または null

呼び出し終了

public void invocationEnded (long elapsedTime)

呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。

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

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

呼び出し失敗

public void invocationFailed (FailureDescription failure)

何らかのエラー状態による不完全な呼び出しを報告します。

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

パラメーター
failure	FailureDescription : 失敗の原因を説明するFailureDescription

呼び出し失敗

public void invocationFailed (Throwable cause)

何らかのエラー状態による不完全な呼び出しを報告します。

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

パラメーター
cause	Throwable : ERROR(/Throwable)失敗の原因

呼び出し開始

public void invocationStarted (IInvocationContext context)

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

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

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

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 。

テスト終了

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 : ERROR(/System#currentTimeMillis())を介して測定された、テストが終了した時間
testMetrics	: 発行されたメトリックのERROR(/Map)

テスト終了

public void testEnded (TestDescription test, 
                 testMetrics)

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

testFailed(TestDescription, FailureDescription)が呼び出されなかった場合、このテストは成功しました。また、テスト ケースの実行中に発行された可能性のあるキー/値メトリックも返します。

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

テスト失敗

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

パラメーター
test	TestDescription : テストを識別します
failure	FailureDescription : 失敗とそのコンテキストを説明するFailureDescription 。

テスト失敗

public void testFailed (TestDescription test, 
                String trace)

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

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

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

テスト無視

public void testIgnored (TestDescription test)

通常、テストメソッドに org.junit.Ignore の注釈が付けられているため、テストが実行されない場合に呼び出されます。

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

テストログ

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

テスト呼び出しから関連するログまたはデバッグ データを提供します。

ERROR(/ITestInvocationListener#invocationFailed(Throwable))またはERROR(/ITestInvocationListener#invocationEnded(long))の前に呼び出す必要があります

TradeFederation フレームワークは、このメソッドを自動的に呼び出し、ホスト ログと、該当する場合はデバイスの logcat を提供します。

パラメーター
dataName	String : データのERROR(/String)記述名。例: "device_logcat"。注意 dataName は、呼び出しごとに一意ではない場合があります。つまり、実装者は同じ dataName で複数の呼び出しを処理できなければなりません
dataType	LogDataType : データのLogDataType
dataStream	InputStreamSource : データのInputStreamSource 。実装者は createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の InputStream を確実に閉じる必要があります。呼び出し元は、testLog メソッドが完了するまで、データのソースが存在し、アクセス可能であることを確認する必要があります。

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescriptionで説明されているエラーのため、レポートのテスト実行を完了できませんでした。

パラメーター
failure	FailureDescription : 失敗とそのコンテキストを説明するFailureDescription 。

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

パラメーター
runName	String : テスト実行名
testCount	int : テスト実行中のテストの総数
attemptNumber	int : 複数回実行される同じ runName の異なる試行を識別する順序番号。 AttemptNumber のインデックスは 0 であり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは詳細に 3 回再試行されます。同じ runName で合計 4 回実行する必要があり、attemptNumber は 0 から 3 です。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

パラメーター
runName	String : テスト実行名
testCount	int : テスト実行中のテストの総数

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

パラメーター
runName	String : テスト実行名
testCount	int : テスト実行中のテストの総数
attemptNumber	int : 複数回実行される同じ runName の異なる試行を識別する順序番号。 AttemptNumber のインデックスは 0 であり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは詳細に 3 回再試行されます。同じ runName で合計 4 回実行する必要があり、attemptNumber は 0 から 3 です。
startTime	long : 実行が開始された時間、 ERROR(/System#currentTimeMillis())で測定

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: 現在使用されていません。削除を検討してください

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

テスト開始

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 : ERROR(/System#currentTimeMillis())を介して測定された、テストの開始時間

テスト開始

public void testStarted (TestDescription test)

個々のテスト ケースの開始を報告します。古いインターフェースでは、可能な限りtestStarted(com.android.tradefed.result.TestDescription)を使用する必要があります。

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

保護されたメソッド

getListeners

protected  getListeners ()

リスナーのリストを取得します。サブクラスによる使用のみを目的としています。

戻り値
	ITestInvocationListenerのリスト。

setListeners

protected void setListeners (ITestInvocationListener... listeners)

構築後にリスナーを設定します。サブクラスによる使用のみを目的としています。

パラメーター
listeners	ITestInvocationListener : 結果を転送する実際のITestInvocationListener s

setListeners

protected void setListeners ( listeners)

構築後にリスナーを設定します。サブクラスによる使用のみを目的としています。

パラメーター
listeners	: 結果を転送する実際のITestInvocationListener s