ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

分割されたテスト呼び出しの結果を結合するResultForwarder 。シャードされたすべての呼び出しが完了すると、呼び出しの完了がリスナーにのみ報告されます。

このクラスはスレッドセーフではありません。呼び出しコールバックが順不同で呼び出されるのを防ぐために、クライアントはテスト結果を送信するときにこのクラスをロックすることが期待されます。

まとめ

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

ShardMainResultForwarder ( listeners, int expectedShards) ShardMainResultForwarder ( listeners, int expectedShards)

ShardMainResultForwarderを作成します。

公開メソッド

getListeners ()

リスナーのリストを取得します。

void invocationEnded (long elapsedTime)

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

void invocationEnded (long elapsedTime, IInvocationContext context)

どのシャードが終了したかを区別するためのより詳細なコールバック。

void invocationFailed ( FailureDescription failure)

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

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 testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream)

最初にログを保存する代わりに、testLog のみを転送します。

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

テスト ログが保存されるときに呼び出されます。

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

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

ShardMainResultForwarderを作成します。

パラメーター
listeners : すべてのシャードが完了したときに結果を転送するITestInvocationListenerのリスト

expectedShards int : シャードの数

公開メソッド

getListeners

public  getListeners ()

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

戻り値
ITestInvocationListenerのリスト。

呼び出し終了

public void invocationEnded (long elapsedTime)

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

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

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

呼び出し終了

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

どのシャードが終了したかを区別するためのより詳細なコールバック。

パラメーター
elapsedTime long

context IInvocationContext

呼び出し失敗

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

ログ関連付け

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 。

testLogForward

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

最初にログを保存する代わりに、testLog のみを転送します。

パラメーター
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

テスト ログが保存されるときに呼び出されます。

ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)の代わりに使用する必要があります。

パラメーター
dataName String : データのERROR(/String)記述名。例: "device_logcat"。注意 dataName は、呼び出しごとに一意ではない場合があります。つまり、実装者は同じ dataName で複数の呼び出しを処理できなければなりません

dataType LogDataType : データのLogDataType

dataStream InputStreamSource : データのInputStreamSource 。実装者は createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の InputStream を確実に閉じる必要があります。

logFile LogFile : 保存されたファイルのメタデータを含むLogFile 。