シャードリスナー
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
呼び出しシャード (複数のリソースで並行して実行するための呼び出し分割) から結果を収集し、それらを別のリスナーに転送するITestInvocationListener
。
まとめ
パブリック コンストラクター | |
---|---|
ShardListener ( ITestInvocationListener main) |
公開メソッド | |
---|---|
getUnderlyingResultReporter () | |
void | invocationEnded (long elapsedTime) 呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。 |
void | invocationFailed ( FailureDescription failure) 何らかのエラー状態による不完全な呼び出しを報告します。 |
void | invocationFailed (Throwable cause) 何らかのエラー状態による不完全な呼び出しを報告します。 |
void | invocationStarted ( IInvocationContext context) テスト呼び出しの開始を報告します。 |
void | logAssociation (String dataName, LogFile logFile) 場合によっては、ログをテスト ケースと強く関連付ける必要がありますが、直接 |
void | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () レポーターが詳細な結果をサポートしている場合は True を返し、そうでない場合は False を返します。 |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) テスト呼び出しから関連するログまたはデバッグ データを提供します。 |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testModuleEnded () モジュール実行の終了を報告します。 |
void | testModuleStarted ( IInvocationContext moduleContext) 実行中のモジュールの開始を報告します。 |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) テスト実行の終了を報告します。 |
void | testRunFailed ( FailureDescription failure) |
void | testRunFailed (String failureMessage) 致命的なエラーのため、レポートのテスト実行を完了できませんでした。 |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) テスト実行の開始を報告します。 |
パブリック コンストラクター
シャードリスナー
public ShardListener (ITestInvocationListener main)
ShardListener
を作成します。
パラメーター | |
---|---|
main | ITestInvocationListener : 結果を転送するITestInvocationListener 。他のShardListener との衝突を防ぐために、このオブジェクトは結果を転送するときにmainで同期します。結果は、呼び出しシャードが完了するまで送信されません。 |
公開メソッド
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
戻り値 | |
---|---|
呼び出し終了
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 : 呼び出しに関する情報 |
ログ関連付け
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 。 |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
パラメーター | |
---|---|
enableGranularResults | boolean |
supportGranularResults
public boolean supportGranularResults ()
レポーターが詳細な結果をサポートしている場合は True を返し、そうでない場合は False を返します。
戻り値 | |
---|---|
boolean |
テストログ
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 メソッドが完了するまで、データのソースが存在し、アクセス可能であることを確認する必要があります。 |
testLogSaved
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
パラメーター | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
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 failureMessage)
致命的なエラーのため、レポートのテスト実行を完了できませんでした。
パラメーター | |
---|---|
failureMessage | String : 実行失敗の理由を説明するERROR(/String) 。 |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
テスト実行の開始を報告します。
パラメーター | |
---|---|
name | String : テスト実行名 |
numTests | int : テスト実行中のテストの総数 |
attemptNumber | int : 複数回実行される同じ runName の異なる試行を識別する順序番号。 AttemptNumber のインデックスは 0 であり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは詳細に 3 回再試行されます。同じ runName で合計 4 回実行する必要があり、attemptNumber は 0 から 3 です。 |
startTime | long : 実行が開始された時間、 ERROR(/System#currentTimeMillis()) で測定 |