ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

---

結果のリストを収集するために、各モジュールの各 IRemoteTest にアタッチされたリスナー。

概要

パブリック コンストラクタ
ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext) コンストラクタ。

パブリック メソッド
boolean	hasLastAttemptFailed() リスナーの最後の再試行セッションが失敗したかどうかを返します。
void	logAssociation(String dataName, LogFile logFile) 場合によっては、ログをテストケースに強く関連付ける必要がありますが、直接の testLogSaved(String,LogDataType,InputStreamSource,LogFile) コールバックでそれを行うことはできません。
void	setAttemptIsolation(CurrentInvocation.IsolationGrade isolation) 試行を分離されたものとして報告するかどうかを設定します。
void	setCollectTestsOnly(boolean collectTestsOnly) テストのみを収集するかどうかを設定します。
void	setMarkTestsSkipped(boolean skip) すべてのテストケースをスキップとしてマークするかどうか。
void	setTestMappingSources(List<String> testMappingSources) 指標に挿入されるテスト マッピング ソースを設定します。
void	setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
void	testAssumptionFailure(TestDescription test, String trace) アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます。
void	testAssumptionFailure(TestDescription test, FailureDescription failure) アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます。
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) 個々のテストケースの実行終了を報告します。
void	testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) 終了時間を直接指定できる testEnded(TestDescription,Map) の代替。
void	testFailed(TestDescription test, FailureDescription failure) 個々のテストケースの失敗を報告します。
void	testFailed(TestDescription test, String trace) 個々のテストケースの失敗を報告します。
void	testIgnored(TestDescription test) テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付いていることが原因です。
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics) テスト実行の終了を報告します。
void	testRunFailed(FailureDescription failure) FailureDescription で説明されているエラーのため、レポート テスト実行を完了できませんでした。
void	testRunFailed(String errorMessage) 致命的なエラーのため、レポートのテスト実行を完了できませんでした。
void	testRunStarted(String name, int numTests, int attemptNumber) テスト実行の開始を報告します。
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) テスト実行の開始を報告します。
void	testSkipped(TestDescription test, SkipReason reason) テストがスキップされ、通常は想定されない理由で実行されなかった場合に呼び出されます。
void	testStarted(TestDescription test, long startTime) testStarted(TestDescription) の代替。テストの開始時刻も指定し、testEnded(TestDescription,long,Map) と組み合わせて正確な測定を行います。

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

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

コンストラクタ。

パラメータ
listener	ITestInvocationListener
moduleContext	IInvocationContext

パブリック メソッド

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

リスナーの最後の再試行セッションが失敗したかどうかを返します。

戻り値
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

ログをテストケースに強く関連付ける必要がある場合もありますが、直接の testLogSaved(String,LogDataType,InputStreamSource,LogFile) コールバックでそれを行うことはできません。したがって、このコールバックを使用すると、強力な関連付けを明示的に指定できます。

パラメータ
dataName	String: データの名前
logFile	LogFile: 以前にロギングされ、テストケースに関連付ける必要がある LogFile。

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

試行を分離されたものとして報告するかどうかを設定します。

パラメータ
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

テストのみを収集するかどうかを設定します。

パラメータ
collectTestsOnly	boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

すべてのテストケースをスキップとしてマークするかどうか。

パラメータ
skip	boolean

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

指標に挿入されるテスト マッピング ソースを設定します。

パラメータ
testMappingSources	List

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

パラメータ
useModuleResultsForwarder	boolean

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestDescription, FailureDescription) が呼び出されなかった場合、このテストは合格です。テストケースの実行中に生成された Key-Value 指標も返します。

パラメータ
test	TestDescription: テストを識別します
testMetrics	HashMap: 出力された指標の Map

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

終了時間を直接指定できる testEnded(TestDescription,Map) の代替。testStarted(TestDescription,long) と組み合わせて正確な測定を行います。

パラメータ
test	TestDescription: テストを識別します
endTime	long: テストが終了した時刻（System.currentTimeMillis() で測定）
testMetrics	HashMap: 出力された指標の 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: テストを識別します

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

パラメータ
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

パラメータ
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

テスト実行の終了を報告します。FIXME: 型が異なる Map<> インターフェースを 2 つ持つことはできないため、ここでは HashMap を使用する必要があります。

パラメータ
elapsedTime	long: デバイスが報告した経過時間（ミリ秒単位）
runMetrics	HashMap: Metric を使用したテスト実行の最後にレポートされる 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 name, 
                int numTests, 
                int attemptNumber)

テスト実行の開始を報告します。

パラメータ
name	String: テスト実行名
numTests	int: テスト実行のテストの合計数
attemptNumber	int: 実行名が同じで複数回実行される異なる試行を識別する注文番号。attemptNumber は 0 から始まり、新しい実行が発生するたびに増分されます。たとえば、テストが 3 回きめ細かく再試行される場合、同じ runName で合計 4 回の実行が行われ、attemptNumber は 0 ～ 3 になります。

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

テスト実行の開始を報告します。

パラメータ
name	String: テスト実行名
numTests	int: テスト実行のテストの合計数
attemptNumber	int: 実行名が同じで複数回実行される異なる試行を識別する注文番号。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(TestDescription) の代替。テストの開始時刻も指定し、testEnded(TestDescription,long,Map) と組み合わせて正確な測定を行います。

パラメータ
test	TestDescription: テストを識別します
startTime	long: テストが開始された時刻（System.currentTimeMillis() で測定）