EventsLoggerListener
public
class
EventsLoggerListener
extends Object
implements
ILogSaverListener
java.lang.Object | |
↳ | com.android.tradefed.result.EventsLoggerListener |
受信したすべてのイベントをファイルに記録するリスナー
概要
パブリック コンストラクタ | |
---|---|
EventsLoggerListener(String name)
|
パブリック メソッド | |
---|---|
File
|
getLoggedEvents()
|
void
|
invocationEnded(long elapsedTime)
正常に終了したか、なんらかのエラー状態が原因で呼び出しが終了したことを報告します。 |
void
|
invocationFailed(FailureDescription failure)
エラー状態が原因で呼び出しが完了しなかったことを報告します。 |
void
|
invocationSkipped(SkipReason reason)
呼び出しをスキップ済みとして報告 |
void
|
invocationStarted(IInvocationContext context)
テスト呼び出しの開始を報告します。 |
void
|
logAssociation(String dataName, LogFile logFile)
場合によっては、ログをテストケースに強く関連付ける必要があります。ただし、直接の |
void
|
testAssumptionFailure(TestDescription test, String trace)
アトミック テストで、条件が false であるとフラグが立てられたときに呼び出されます。 |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
アトミック テストが false の条件を前提としていることを報告するフラグが立てられたときに呼び出されます。 |
void
|
testEnded(TestDescription test, long endTime,
終了時間を直接指定できる |
void
|
testFailed(TestDescription test, FailureDescription failure)
個々のテストケースの失敗を報告します。 |
void
|
testFailed(TestDescription test, String trace)
個々のテストケースの失敗を報告します。 |
void
|
testIgnored(TestDescription test)
テストが実行されない場合に呼び出されます。通常は、テストメソッドに org.junit.Ignore がアノテーションされているためです。 |
void
|
testModuleEnded()
モジュールの実行の終了を報告します。 |
void
|
testModuleStarted(IInvocationContext moduleContext)
モジュールの実行開始を報告します。 |
void
|
testRunEnded(long elapsedTimeMillis,
テスト実行の終了を報告します。 |
void
|
testRunFailed(FailureDescription failure)
|
void
|
testRunFailed(String errorMessage)
致命的なエラーが発生したため、レポートのテスト実行が完了しませんでした。 |
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
|
testSkipped(TestDescription test, SkipReason reason)
通常想定されない理由でテストがスキップされ、実行されなかった場合に呼び出されます。 |
void
|
testStarted(TestDescription test, long startTime)
|
パブリック コンストラクタ
EventsLoggerListener
public EventsLoggerListener (String name)
パラメータ | |
---|---|
name |
String |
パブリック メソッド
getLoggedEvents
public File getLoggedEvents ()
戻り値 | |
---|---|
File |
invocationEnded
public void invocationEnded (long elapsedTime)
正常に終了したか、なんらかのエラー状態が原因で呼び出しが終了したことを報告します。
TradeFederation フレームワークによって自動的に呼び出されます。
パラメータ | |
---|---|
elapsedTime |
long : 呼び出しの所要時間(ミリ秒単位) |
invocationFailed
public void invocationFailed (FailureDescription failure)
エラー状態が原因で呼び出しが完了しなかったことを報告します。
TradeFederation フレームワークによって自動的に呼び出されます。
パラメータ | |
---|---|
failure |
FailureDescription : 障害の原因を説明する FailureDescription |
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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
コールバックでそうすることはできません。したがって、このコールバックを使用すると、強力な関連付けを明示的に指定できます。
パラメータ | |
---|---|
dataName |
String : データの名前 |
logFile |
LogFile : 前にロギングされ、テストケースに関連付ける必要がある LogFile 。 |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
アトミック テストが false の条件を前提としていることを報告するフラグが立てられたときに呼び出されます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
trace |
String : 障害のスタック トレース |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
アトミック テストが false の条件を前提としていることを報告するフラグが立てられたときに呼び出されます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
failure |
FailureDescription : エラーとそのコンテキストを記述する FailureDescription 。 |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
の代わりに、終了時間を直接指定できます。testStarted(com.android.tradefed.result.TestDescription, long)
と組み合わせて使用すると、正確に測定できます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
endTime |
long : テストが終了した時刻(System.currentTimeMillis() で測定) |
testMetrics |
: 出力された指標の ERROR(/Map) |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
個々のテストケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
failure |
FailureDescription : 障害とそのコンテキストを記述する FailureDescription 。 |
testFailed
public void testFailed (TestDescription test, String trace)
個々のテストケースの失敗を報告します。
testStarted と testEnded の間で呼び出されます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
trace |
String : 障害のスタック トレース |
testIgnored
public void testIgnored (TestDescription test)
テストが実行されない場合に呼び出されます(通常は、テストメソッドに org.junit.Ignore がアノテーションされているため)。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
testModuleEnded
public void testModuleEnded ()
モジュールの実行の終了を報告します。
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
モジュールの実行開始を報告します。このコールバックは testModuleEnded()
に関連付けられており、シーケンスでは省略可能です。モジュール(スイートベースのランナー)を使用する実行中にのみ使用されます。
パラメータ | |
---|---|
moduleContext |
IInvocationContext : モジュールの IInvocationContext 。 |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
テスト実行の終了をレポートします。
パラメータ | |
---|---|
elapsedTimeMillis |
long : デバイスが報告した経過時間(ミリ秒単位) |
runMetrics |
: テスト実行の終了時にレポートされる Key-Value ペア |
testRunFailed
public void testRunFailed (FailureDescription failure)
FailureDescription
で説明されているエラーにより、テスト実行が完了しなかったことを報告します。
パラメータ | |
---|---|
failure |
FailureDescription : 障害とそのコンテキストを記述する FailureDescription 。 |
testRunFailed
public void testRunFailed (String errorMessage)
致命的なエラーが発生したため、レポートのテスト実行が完了しませんでした。
パラメータ | |
---|---|
errorMessage |
String : 実行失敗の理由を説明する String 。 |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
テスト実行の開始を報告します。
パラメータ | |
---|---|
runName |
String : テスト実行名 |
testCount |
int : テスト実行のテスト数の合計 |
attemptNumber |
int : オーダー番号。同じ runName を複数回実行する際の試行を識別します。tryNumber の値は 0 から始まり、新しい実行が発生するたびに増加します。たとえば、テストを 3 回細かく再試行する場合、同じ runName で合計 4 回の実行を行い、AttemptNumber は 0 ~ 3 になります。 |
testRunStarted
public void testRunStarted (String runName, int testCount)
テスト実行の開始を報告します。
パラメータ | |
---|---|
runName |
String : テスト実行名 |
testCount |
int : テスト実行のテスト数の合計 |
testRunStarted
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() で測定) |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
通常想定されない理由でテストがスキップされ、実行されなかった場合に呼び出されます。これらのテストは、適切な実行を試すために再試行されます。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
testStarted(com.android.tradefed.result.TestDescription)
に代わるもので、テストの開始日時も指定します。正確な測定のために ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
と組み合わせて使用します。
パラメータ | |
---|---|
test |
TestDescription : テストを識別します。 |
startTime |
long : テストの開始時間(System.currentTimeMillis() で測定) |