ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

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

このクラスはスレッドセーフではありません。クライアントは、テスト結果を送信するときにこのクラスをロックして、呼び出しのコールバックが順不同で呼び出されないようにする必要があります。

概要

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

ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)

ShardMainResultForwarder を作成します。

パブリック メソッド

List<ITestInvocationListener> 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,LogDataType,InputStreamSource,LogFile) コールバックでそれを行うことはできません。

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

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

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

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

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

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

ShardMainResultForwarder を作成します。

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

パブリック メソッド

getListeners

public List<ITestInvocationListener> getListeners ()

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

戻り値
List<ITestInvocationListener> ITestInvocationListener のリスト。

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

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

パラメータ
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

エラー条件が原因で呼び出しが完了しなかったことを報告します。

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

パラメータ
failure FailureDescription: 失敗の原因を説明する 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,LogDataType,InputStreamSource,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: データの説明的な名前（例: "device_logcat"）。String注 dataName は呼び出しごとに一意でない場合があります。つまり、実装者は 同じ dataName で複数の呼び出しを処理できる必要があります。
dataType LogDataType: データの LogDataType
dataStream InputStreamSource：データの InputStreamSource。実装者は createInputStream を呼び出してデータの読み取りを開始し、完了したら結果の InputStream を閉じる必要があります。
logFile LogFile: 保存されたファイルのメタデータを含む LogFile。