サブプロセス結果レポーター
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.オブジェクト | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
ITestInvocationListener
result_reporter として指定し、テスト、テスト実行、テスト呼び出しの結果をサブプロセスから転送するように実装します。
まとめ
パブリックコンストラクター | |
---|---|
SubprocessResultsReporter () |
パブリックメソッド | |
---|---|
void | close () |
TestSummary | getSummary () InvocationListener が概要を返すことを許可します。 |
void | invocationEnded (long elapsedTime) 正常に終了したか、何らかのエラー条件により呼び出しが終了したことを報告します。 |
void | invocationFailed ( FailureDescription failure) 何らかのエラー状態が原因で不完全な呼び出しを報告します。 |
void | invocationFailed (Throwable cause) 何らかのエラー状態が原因で不完全な呼び出しを報告します。 |
void | invocationStarted ( IInvocationContext context) テスト呼び出しの開始を報告します。 |
void | logAssociation (String dataName, LogFile logFile) 場合によっては、ログをテスト ケースと強く関連付ける必要がありますが、直接 |
void | printEvent (String key, Object event) イベントキーを出力してからjsonオブジェクトを出力するヘルパー。 |
void | setOutputTestLog (boolean outputTestLog) テストのログを出力するかどうかを設定します。 |
boolean | supportGranularResults () レポーターが詳細な結果をサポートする場合は True を返し、そうでない場合は false を返します。 |
void | testAssumptionFailure ( TestDescription testId, String trace) アトミック テストが条件が false であると仮定することを示すフラグを立てたときに呼び出されます。 |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) アトミック テストが条件が false であると仮定することを示すフラグを立てたときに呼び出されます。 |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) 個々のテスト ケースの実行終了を報告します。 |
void | testFailed ( TestDescription testId, FailureDescription failure) 個々のテスト ケースの失敗を報告します。 |
void | testFailed ( TestDescription testId, String reason) 個々のテスト ケースの失敗を報告します。 |
void | testIgnored ( TestDescription testId) 通常、テスト メソッドに org.junit.Ignore アノテーションが付けられているため、テストが実行されないときに呼び出されます。 |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) テスト呼び出しからの関連ログまたはデバッグ データを提供します。 |
void | testModuleEnded () モジュールの実行の終了を報告します。 |
void | testModuleStarted ( IInvocationContext moduleContext) モジュールの実行の開始を報告します。 |
void | testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics) テスト実行の終了を報告します。 |
void | testRunFailed ( FailureDescription failure) |
void | testRunFailed (String reason) レポートのテスト実行は、致命的なエラーのため完了できませんでした。 |
void | testRunStarted (String runName, int testCount, int attemptNumber) テスト実行の開始を報告します。 |
void | testRunStarted (String runName, int testCount) テスト実行の開始を報告します。 |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) テスト実行の開始を報告します。 |
void | testRunStopped (long arg0) ユーザーの要求により、テスト実行が完了前に停止したことをレポートします。 |
void | testStarted ( TestDescription testId, long startTime) |
void | testStarted ( TestDescription testId) 個々のテスト ケースの開始を報告します。 |
パブリックコンストラクター
サブプロセス結果レポーター
public SubprocessResultsReporter ()
パブリックメソッド
近い
public void close ()
get概要
public TestSummary getSummary ()
InvocationListener が概要を返すことを許可します。
戻り値 | |
---|---|
TestSummary | 実行を要約したTestSummary または null |
呼び出し終了
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 : 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 printEvent (String key, Object event)
イベントキーを出力してからjsonオブジェクトを出力するヘルパー。
パラメーター | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
テストのログを出力するかどうかを設定します。
パラメーター | |
---|---|
outputTestLog | boolean |
サポート粒状の結果
public boolean supportGranularResults ()
レポーターが詳細な結果をサポートする場合は True を返し、そうでない場合は false を返します。
戻り値 | |
---|---|
boolean |
テスト仮定失敗
public void testAssumptionFailure (TestDescription testId, String trace)
アトミック テストが条件が false であると仮定することを示すフラグを立てたときに呼び出されます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
trace | String : 失敗のスタック トレース |
テスト仮定失敗
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
アトミック テストが条件が false であると仮定することを示すフラグを立てたときに呼び出されます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
failure | FailureDescription : 失敗とそのコンテキストを説明するFailureDescription 。 |
テスト終了
public void testEnded (TestDescription testId, long endTime,metrics)
ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
の代わりに、終了時刻を直接指定できます。正確に測定するにはtestStarted(com.android.tradefed.result.TestDescription, long)
と組み合わせます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
endTime | long : System.currentTimeMillis() によって測定されたテスト終了時刻 |
metrics | ERROR(/Map) |
テスト終了
public void testEnded (TestDescription testId,metrics)
個々のテスト ケースの実行終了を報告します。
testFailed(TestDescription, FailureDescription)
呼び出されなかった場合、このテストは合格です。また、テスト ケースの実行中に出力された可能性のあるキー/値メトリクスも返します。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
metrics | ERROR(/Map) |
テスト失敗
public void testFailed (TestDescription testId, FailureDescription failure)
個々のテスト ケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
failure | FailureDescription : 失敗とそのコンテキストを説明するFailureDescription 。 |
テスト失敗
public void testFailed (TestDescription testId, String reason)
個々のテスト ケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
reason | String : 失敗のスタック トレース |
テスト無視されました
public void testIgnored (TestDescription testId)
通常、テスト メソッドに org.junit.Ignore アノテーションが付けられているため、テストが実行されないときに呼び出されます。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
テストログ
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
テスト呼び出しからの関連ログまたはデバッグ データを提供します。
ERROR(/ITestInvocationListener#invocationFailed(Throwable))
またはERROR(/ITestInvocationListener#invocationEnded(long))
の前に呼び出す必要があります。 TradeFederation フレームワークは自動的にこのメソッドを呼び出し、ホスト ログと、該当する場合はデバイス logcat を提供します。パラメーター | |
---|---|
dataName | String : データを説明するString 名。たとえば、「device_logcat」。 dataName は呼び出しごとに一意ではない場合があることに注意してください。つまり、実装者は同じ dataName で複数の呼び出しを処理できなければなりません |
dataType | LogDataType : データのLogDataType |
dataStream | InputStreamSource : データのInputStreamSource 。実装者は、createInputStream を呼び出してデータの読み取りを開始し、完了したら結果として得られた InputStream を確実に閉じる必要があります。呼び出し元は、testLog メソッドが完了するまで、データのソースが存在し、アクセス可能な状態にあることを確認する必要があります。 |
テストモジュール終了
public void testModuleEnded ()
モジュールの実行の終了を報告します。
テストモジュールが開始されました
public void testModuleStarted (IInvocationContext moduleContext)
モジュールの実行の開始を報告します。このコールバックはtestModuleEnded()
に関連付けられており、シーケンス内ではオプションです。これは、モジュール (スイート ベースのランナー) を使用する実行中にのみ使用されます。
パラメーター | |
---|---|
moduleContext | IInvocationContext : モジュールのIInvocationContext 。 |
テスト実行終了
public void testRunEnded (long time,runMetrics)
テスト実行の終了を報告します。修正: タイプの異なる 2 つの Map<> インターフェイスを使用することはできないため、ここでは HashMap を使用する必要があります。
パラメーター | |
---|---|
time | long : デバイスが報告した経過時間 (ミリ秒単位) |
runMetrics | Metric を使用したテスト実行の終了時に報告されたキーと値のペア。 |
テスト実行失敗
public void testRunFailed (FailureDescription failure)
FailureDescription
で説明されている障害のため、レポートのテスト実行が完了できませんでした。
パラメーター | |
---|---|
failure | FailureDescription : 失敗とそのコンテキストを説明するFailureDescription 。 |
テスト実行失敗
public void testRunFailed (String reason)
レポートのテスト実行は、致命的なエラーのため完了できませんでした。
パラメーター | |
---|---|
reason | String : 実行失敗の理由を説明するString 。 |
テスト実行開始しました
public void testRunStarted (String runName, int testCount, int attemptNumber)
テスト実行の開始を報告します。
パラメーター | |
---|---|
runName | String : テスト実行名 |
testCount | int : テスト実行のテストの総数 |
attemptNumber | int : 順序番号。複数回実行される同じ runName の異なる試行を識別します。 attemptNumber は 0 から始まるインデックスであり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは 3 回詳細に再試行され、同じ runName で合計 4 回の実行が必要で、attemptNumber は 0 ~ 3 です。 |
テスト実行開始しました
public void testRunStarted (String runName, int testCount)
テスト実行の開始を報告します。
パラメーター | |
---|---|
runName | String : テスト実行名 |
testCount | int : テスト実行のテストの総数 |
テスト実行開始しました
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
テスト実行の開始を報告します。
パラメーター | |
---|---|
runName | String : テスト実行名 |
testCount | int : テスト実行のテストの総数 |
attemptNumber | int : 順序番号。複数回実行される同じ runName の異なる試行を識別します。 attemptNumber は 0 から始まるインデックスであり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは 3 回詳細に再試行され、同じ runName で合計 4 回の実行が必要で、attemptNumber は 0 ~ 3 です。 |
startTime | long : System.currentTimeMillis() によって測定された実行の開始時刻 |
テスト実行停止
public void testRunStopped (long arg0)
ユーザーの要求により、テスト実行が完了前に停止したことをレポートします。
TODO: 現在使用されていないため、削除することを検討してください
パラメーター | |
---|---|
arg0 | long : デバイスが報告した経過時間 (ミリ秒単位) |
テスト開始
public void testStarted (TestDescription testId, long startTime)
testStarted(com.android.tradefed.result.TestDescription)
の代わりに、テストの開始時期も指定し、正確な測定のためにERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
と組み合わせます。 。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |
startTime | long : System.currentTimeMillis() によって測定されたテストの開始時刻 |
テスト開始
public void testStarted (TestDescription testId)
個々のテスト ケースの開始を報告します。古いインターフェイスでは、可能な限りtestStarted(com.android.tradefed.result.TestDescription)
を使用する必要があります。
パラメーター | |
---|---|
testId | TestDescription : テストを識別します |