ModuleListener

public class ModuleListener
extends CollectingTestListener

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

---

Listener, der an jede IRemoteTest jedes Moduls angehängt ist, um die Liste der Ergebnisse zu erfassen.

Zusammenfassung

Öffentliche Konstruktoren
ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext) Konstruktor.

Öffentliche Methoden
boolean	hasLastAttemptFailed() Gibt an, ob der letzte Wiederholungsversuch des Listeners fehlgeschlagen ist.
void	logAssociation(String dataName, LogFile logFile) In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist.
void	setAttemptIsolation(CurrentInvocation.IsolationGrade isolation) Legt fest, ob der Versuch als vereinzelt gemeldet werden soll.
void	setCollectTestsOnly(boolean collectTestsOnly) Legt fest, ob nur die Tests erfasst werden sollen.
void	setMarkTestsSkipped(boolean skip) Ob alle Testfälle als übersprungen markiert werden sollen.
void	setTestMappingSources( testMappingSources) Hiermit werden Testzuordnungsquellen festgelegt, die in Messwerte eingefügt werden.
void	testAssumptionFailure(TestDescription test, String trace) Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
void	testEnded(TestDescription test, long endTime, testMetrics) Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können.
void	testEnded(TestDescription test, testMetrics) Gibt das Ende der Ausführung eines einzelnen Testfalls an.
void	testFailed(TestDescription test, FailureDescription failure) Hier wird der Fehler eines einzelnen Testfalls gemeldet.
void	testFailed(TestDescription test, String trace) Hier wird der Fehler eines einzelnen Testfalls gemeldet.
void	testIgnored(TestDescription test) Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel weil eine Testmethode mit org.junit.Ignore annotiert ist.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testRunEnded(long elapsedTime, runMetrics) Gibt das Ende des Testlaufs an.
void	testRunFailed(FailureDescription failure) Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, nicht abgeschlossen werden.
void	testRunFailed(String errorMessage) Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
void	testRunStarted(String name, int numTests, int attemptNumber) Gibt den Beginn eines Testlaufs an.
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) Gibt den Beginn eines Testlaufs an.
void	testSkipped(TestDescription test, SkipReason reason) Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.
void	testStarted(TestDescription test, long startTime) Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

Öffentliche Konstruktoren

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Konstruktor.

Parameter
listener	ITestInvocationListener
moduleContext	IInvocationContext

Öffentliche Methoden

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Gibt an, ob der letzte Wiederholungsversuch des Listeners fehlgeschlagen ist.

Returns
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist. So kann mit diesem Rückruf eine starke Verknüpfung explizit angegeben werden.

Parameter
dataName	String: Der Name der Daten
logFile	LogFile: die LogFile, die zuvor protokolliert wurde und mit dem Testfall verknüpft werden soll.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Legt fest, ob der Versuch als vereinzelt gemeldet werden soll.

Parameter
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Legt fest, ob nur die Tests erfasst werden sollen.

Parameter
collectTestsOnly	boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Ob alle Testfälle als übersprungen markiert werden sollen.

Parameter
skip	boolean

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Hiermit werden Testzuordnungsquellen festgelegt, die in Messwerte eingefügt werden.

Parameter
testMappingSources

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
test	TestDescription: identifiziert den Test
trace	String: Stack-Trace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
test	TestDescription: identifiziert den Test
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. Kombinieren Sie diesen Messwert mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.

Parameter
test	TestDescription: identifiziert den Test
endTime	long: Die Uhrzeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis()
testMetrics	: ERROR(/Map) der gesendeten Messwerte

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Außerdem werden alle Schlüssel/Wert-Messwerte zurückgegeben, die während der Ausführung des Testfalls gesendet wurden.

Parameter
test	TestDescription: identifiziert den Test
testMetrics	: ERROR(/Map) der gesendeten Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test	TestDescription: identifiziert den Test
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test	TestDescription: identifiziert den Test
trace	String: Stack-Trace des Fehlers

testIgnored

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel weil eine Testmethode mit org.junit.Ignore annotiert ist.

Parameter
test	TestDescription: identifiziert den Test

testLog

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

Parameter
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

Parameter
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Gibt das Ende des Testlaufs an.

Parameter
elapsedTime	long: Vom Gerät gemeldete verstrichene Zeit in Millisekunden
runMetrics	: Schlüssel/Wert-Paare, die am Ende eines Testlaufs erfasst werden

testRunFailed

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, nicht abgeschlossen werden.

Parameter
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testRunFailed

public void testRunFailed (String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage	String: String mit einer Beschreibung des Grunds für den Ausführungsfehler.

testRunStarted

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

Gibt den Beginn eines Testlaufs an.

Parameter
name	String: der Name des Testlaufs
numTests	int: Gesamtzahl der Tests im Testlauf
attemptNumber	int: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe mit demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen.

testRunStarted

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

Gibt den Beginn eines Testlaufs an.

Parameter
name	String: der Name des Testlaufs
numTests	int: Gesamtzahl der Tests im Testlauf
attemptNumber	int: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte es insgesamt vier Durchläufe mit demselben „runName“ geben und die „attemptNumber“ sollte von 0 auf 3 steigen.
startTime	long: Zeitpunkt des Beginns der Ausführung, gemessen über System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. Diese Tests werden wiederholt, um eine korrekte Ausführung zu erreichen.

Parameter
test	TestDescription: identifiziert den Test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

Parameter
test	TestDescription: identifiziert den Test
startTime	long: Die Uhrzeit, zu der der Test gestartet wurde, gemessen über System.currentTimeMillis()