ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.オブジェクト
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 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)で関連付けることができます。 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 : Throwableの失敗の原因

呼び出しがスキップされました

public void invocationSkipped (SkipReason reason)

呼び出しがスキップされたと報告します

パラメーター
reason SkipReason

呼び出し開始

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)で関連付けることができます。 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)コールバックはできません。したがって、このコールバックにより、強力な関連付けを明示的に提供できます。

パラメーター
dataName String : データの名前

logFile LogFile : 以前にログに記録され、テスト ケースに関連付ける必要があるLogFile

テストログフォワード

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

最初にログを保存するのではなく、testLog のみを転送します。

パラメーター
dataName String

dataType LogDataType

dataStream InputStreamSource

テストログが保存されました

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

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

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

パラメーター
dataName String : データを説明するString名。たとえば、「device_logcat」。 dataName は呼び出しごとに一意ではない場合があることに注意してください。つまり、実装者は同じ dataName で複数の呼び出しを処理できなければなりません

dataType LogDataType : データのLogDataType

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

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