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) |
パブリックメソッド | |
---|---|
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) 場合によっては、ログをテスト ケースと強く関連付ける必要がありますが、直接 |
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
publicgetListeners ()
リスナーのリストを取得します。サブクラスによる使用のみを目的としています。
戻り値 | |
---|---|
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 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 。 |