ModuleListener

public class ModuleListener
extends CollectingTestListener

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

Listener, der an jedes 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 zurück, ob der letzte Wiederholungsversuch des Listeners fehlgeschlagen ist.

void logAssociation(String dataName, LogFile logFile)

In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String,LogDataType,InputStreamSource,LogFile)-Callback nicht.

void setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)

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

void setCollectTestsOnly(boolean collectTestsOnly)

Legt fest, ob nur die Tests erfasst werden.

void setMarkTestsSkipped(boolean skip)

Gibt an, ob alle Testläufe als übersprungen markiert werden sollen.

void setTestMappingSources(List<String> testMappingSources)

Legt Testzuordnungsquellen fest, die in Messwerte eingefügt werden.

void setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
void testAssumptionFailure(TestDescription test, String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

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

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

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

Alternative zu testEnded(TestDescription,Map), mit der wir die Endzeit direkt angeben können.

void testFailed(TestDescription test, FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

void testFailed(TestDescription test, String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

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

Meldet das Ende des Testlaufs.

void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, 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)

Meldet den Beginn eines Testlaufs.

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

Meldet den Beginn eines Testlaufs.

void testSkipped(TestDescription test, SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen wurde und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.

void testStarted(TestDescription test, long startTime)

Alternative zu testStarted(TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit testEnded(TestDescription,long,Map) für eine genaue Messung.

Öffentliche Konstruktoren

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Konstruktor.

Parameter
listener ITestInvocationListener

moduleContext IInvocationContext

Öffentliche Methoden

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Gibt zurück, ob der letzte Wiederholungsversuch des Listeners fehlgeschlagen ist.

Gibt Folgendes zurück:
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String,LogDataType,InputStreamSource,LogFile)-Callback nicht. Mit diesem Callback kann also explizit eine starke Zuordnung angegeben werden.

Parameter
dataName String: Der Name der Daten
logFile LogFile: Die LogFile, die zuvor protokolliert wurde und dem Testlauf zugeordnet werden soll.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

Parameter
isolation CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Legt fest, ob nur die Tests erfasst werden.

Parameter
collectTestsOnly boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Gibt an, ob alle Testläufe als übersprungen markiert werden sollen.

Parameter
skip boolean

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

Legt Testzuordnungsquellen fest, die in Messwerte eingefügt werden.

Parameter
testMappingSources List

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parameter
useModuleResultsForwarder boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

Parameter
test TestDescription: Gibt den Test an.
trace String: Stacktrace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

Parameter
test TestDescription: Gibt den Test an.
failure FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden.

testEnded

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

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
test TestDescription: Gibt den Test an.
testMetrics HashMap: Map der ausgegebenen Messwerte

testEnded

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

Alternative zu testEnded(TestDescription,Map), mit der wir die Endzeit direkt angeben können. Kombinieren Sie sie mit testStarted(TestDescription,long), um genaue Ergebnisse zu erhalten.

Parameter
test TestDescription: Gibt den Test an.
endTime long: Die Uhrzeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis()
testMetrics HashMap: Map der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test TestDescription: Gibt den Test an.
failure FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test TestDescription: Gibt den Test an.
trace String: Stacktrace 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: Gibt den Test an.

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

Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichen Typen haben, daher müssen wir hier HashMap verwenden.

Parameter
elapsedTime long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
runMetrics HashMap: Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden.

testRunFailed

public void testRunFailed (FailureDescription failure)

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

Parameter
failure FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden.

testRunFailed

public void testRunFailed (String errorMessage)

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

Parameter
errorMessage String: String, in dem der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

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

Meldet den Beginn eines Testlaufs.

Parameter
name String: der Name des Testlaufs
numTests int: Gesamtzahl der Tests im Testlauf
attemptNumber int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.

testRunStarted

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

Meldet den Beginn eines Testlaufs.

Parameter
name String: der Name des Testlaufs
numTests int: Gesamtzahl der Tests im Testlauf
attemptNumber int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Beispiel: Ein Test wird dreimal wiederholt. Er sollte insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.
startTime long: Der Zeitpunkt, zu dem der Lauf begonnen hat, gemessen mit System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

Parameter
test TestDescription: Gibt den Test an.
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit testEnded(TestDescription,long,Map) für eine genaue Messung.

Parameter
test TestDescription: Gibt den Test an.
startTime long: Die Uhrzeit, zu der der Test begonnen hat, gemessen über System.currentTimeMillis()