Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener

Bekannte direkte Unterklassen

AndroidBuildResultReporter, JsonHttpTestResultReporter, LUCIResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

AndroidBuildResultReporter	Meldet Testergebnisse an die Android Build API.
JsonHttpTestResultReporter	Ein Ergebnisreporter, der Testergebnisse und Informationen zu Zweig und Gerät in JSON codiert und an einen HTTP-Dienstendpunkt sendet
LUCIResultReporter	Ein Ergebnisreporter, der für ResultDB und LUCI erforderliche Testergebnisse im JSON-Format speichert (go/result-sink) und den Dateispeicherort in der Konsole protokolliert.
MetricsXMLResultReporter	MetricsXMLResultReporter schreibt Testmesswerte und Laufzeitmesswerte in eine XML-Datei in einem Ordner, der durch den Parameter „metrics-folder“ in der Phase „invocationEnded“ des Tests angegeben wird.
ModuleListener	Listener, der an jedes `IRemoteTest` jedes Moduls angehängt ist, um die Liste der Ergebnisse zu erfassen.
ReportPassedTests	Im Bericht in einer Datei können Filter angegeben werden, um bestandene Tests auszuschließen.
ResultAggregator	Spezieller Forwarder, der die Ergebnisse bei Bedarf basierend auf der verwendeten Wiederholungsstrategie zusammenfasst.
ShardListener	Ein `ITestInvocationListener`, das Ergebnisse aus einem Aufruf-Shard (d. h. einem Aufruf, der parallel auf mehreren Ressourcen ausgeführt wird) erfasst und an einen anderen Listener weiterleitet.
SuiteResultReporter	Testergebnisse für einen gesamten Suite-Aufruf erfassen und die endgültigen Ergebnisse ausgeben.
XmlResultReporter	Schreibt JUnit-Ergebnisse in XML-Dateien in einem Format, das mit dem XMLJUnitResultFormatter von Ant kompatibel ist.

Bekannte indirekte Unterklassen

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Reporter, mit dem Berichte in einem bestimmten Format generiert werden können.
XmlFormattedGeneratorReporter	Implementierung von `FormattedGeneratorReporter`, die die Suite-Ergebnisse in einem XML-Format formatiert.

Eine ITestInvocationListener, in der alle Testergebnisse erfasst werden.

Die in diesem Objekt verwendeten Datenstrukturen sind zwar threadsicher, die ITestInvocationListener-Callbacks müssen jedoch in der richtigen Reihenfolge aufgerufen werden.

Zusammenfassung

Öffentliche Konstruktoren
`CollectingTestListener()`

Öffentliche Methoden
`IBuildInfo`	`getBuildInfo()` Diese Methode wurde eingestellt. auf die `IBuildInfo` von `getInvocationContext()` verlassen.
`TestRunResult`	`getCurrentRunResults()` Ruft die Ergebnisse für den aktuellen Testlauf ab.
`int`	`getExpectedTests()` Gibt die Anzahl der erwarteten Tests zurück.
`IInvocationContext`	`getInvocationContext()` Gibt den Aufrufkontext zurück, der über `invocationStarted(IInvocationContext)` gemeldet wurde.
`List<TestRunResult>`	`getMergedTestRunResults()` Gibt die zusammengeführte Sammlung von Ergebnissen für alle Läufe über verschiedene Versuche hinweg zurück.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Gibt den `IInvocationContext` des Moduls zurück, das den Ergebnissen zugeordnet ist.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die dem Modul zugeordnet sind.
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die keinem Testlauf oder Modul zugeordnet sind.
`int`	`getNumAllFailedTestRuns()` Gibt die Gesamtzahl der Testläufe mit dem Status „Fehler“ zurück.
`int`	`getNumAllFailedTests()` Gibt die Gesamtzahl der Tests mit dem Status „Fehler“ zurück. Annahmefehler werden nicht berücksichtigt.
`int`	`getNumTestsInState(TestStatus status)` Gibt die Anzahl der Tests im angegebenen Status für diesen Lauf zurück.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` Zur Kompatibilität mit dem alten Statustyp
`int`	`getNumTotalTests()` Gibt die Gesamtzahl der abgeschlossenen Tests für alle Läufe zurück.
`IBuildInfo`	`getPrimaryBuildInfo()` Gibt die primären Build-Informationen zurück, die über `invocationStarted(IInvocationContext)` gemeldet wurden.
`Collection<TestRunResult>`	`getRunResults()` Diese Methode wurde eingestellt. `getMergedTestRunResults()` verwenden
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Gibt die `TestRunResult` für einen einzelnen Versuch zurück.
`int`	`getTestRunAttemptCount(String testRunName)` Gibt die Anzahl der Versuche für einen bestimmten Testlaufnamen zurück.
`List<TestRunResult>`	`getTestRunAttempts(String testRunName)` Ruft alle Versuche für eine `TestRunResult` eines bestimmten Testlaufs ab.
`List<TestRunResult>`	`getTestRunForAttempts(int attempt)` Ruft alle Ergebnisse für einen bestimmten Versuch ab.
`Collection<String>`	`getTestRunNames()` Gibt alle Namen für alle Testläufe zurück.
`boolean`	`hasFailedTests()` Gibt zurück, ob bei dem Aufruf Tests fehlgeschlagen sind oder Annahmen fehlgeschlagen sind.
`boolean`	`hasTestRunResultsForName(String testRunName)` Gibt zurück, ob für einen bestimmten Testlaufname Ergebnisse vorhanden sind.
`void`	`invocationEnded(long elapsedTime)` Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
`void`	`invocationFailed(Throwable cause)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationSkipped(SkipReason reason)` Meldet einen Aufruf als übersprungen
`void`	`invocationStarted(IInvocationContext context)` Meldet den Beginn des Testaufrufs.
`boolean`	`isDisabled()` Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (sowohl Einrichtung als auch Abbau werden übersprungen).
`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`	`setBuildInfo(IBuildInfo buildInfo)` Diese Methode wurde eingestellt. Für Tests nicht mehr erforderlich.
`void`	`setDisable(boolean isDisabled)` Legt fest, ob das Objekt deaktiviert werden soll.
`void`	`setMergeStrategy(MergeStrategy strategy)` Legt die `MergeStrategy` fest, die beim Zusammenführen von Ergebnissen verwendet werden soll.
`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, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternative zu `testEnded(TestDescription,Map)`, mit der wir die Endzeit direkt angeben können.
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`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`	`testModuleEnded()` Meldet das Ende einer Modulausführung.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Meldet den Beginn der Ausführung eines Moduls.
`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)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.
`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.
`void`	`testStarted(TestDescription test)` Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
`final void`	`clearModuleLogFiles()` Ermöglicht das Bereinigen der Moduldatei, damit sie nicht zu lange mitgeführt werden muss.
`final void`	`clearResultsForName(String testRunName)` Ermöglicht das Löschen der Ergebnisse für einen bestimmten Laufnamen.
`final void`	`clearTestRunResults()` Ermöglicht das Löschen aller Testergebnisse, damit sie nicht zu lange gespeichert werden.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Option „Messwerte zusammenfassen“ ein- oder ausschalten

Öffentliche Konstruktoren

CollectingTestListener

public CollectingTestListener ()

Öffentliche Methoden

getBuildInfo

public IBuildInfo getBuildInfo ()

Diese Methode wurde eingestellt.
IBuildInfo von getInvocationContext() verwenden.

Gibt die Build-Informationen zurück.

Gibt Folgendes zurück:
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Ruft die Ergebnisse für den aktuellen Testlauf ab.

Die Ergebnisse sind möglicherweise unvollständig. Es wird empfohlen, den Wert von TestRunResult.isRunComplete() und/oder {@link TestRunResult#isRunFailure()} vor der Verarbeitung der Ergebnisse zu testen.

Gibt Folgendes zurück:
`TestRunResult`	`TestRunResult` – Daten, die während des letzten Testlaufs erhoben wurden

getExpectedTests

public int getExpectedTests ()

Gibt die Anzahl der erwarteten Tests zurück. Kann von getNumTotalTests() abweichen, wenn einige Tests nicht ausgeführt wurden.

Gibt Folgendes zurück:
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Gibt den Aufrufkontext zurück, der über invocationStarted(IInvocationContext) gemeldet wurde.

Gibt Folgendes zurück:
`IInvocationContext`

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

Gibt die zusammengeführte Sammlung von Ergebnissen für alle Läufe über verschiedene Versuche hinweg zurück.

Wenn mehrere Ergebnisse vorhanden sind, wird jeder Testlauf zusammengeführt. Das jeweils letzte Testergebnis überschreibt die Testergebnisse der vorherigen Läufe. Testläufe werden nach der Versuchsnummer sortiert.

Messwerte für denselben Versuch werden basierend auf der von aggregate-metrics festgelegten Einstellung zusammengeführt. Die endgültigen Messwerte sind die Messwerte des letzten Versuchs.

Gibt Folgendes zurück:
`List<TestRunResult>`

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Gibt den IInvocationContext des Moduls zurück, das den Ergebnissen zugeordnet ist.

Parameter
`testRunName`	`String`: Der Name, der von {`testRunStarted(String,int)` angegeben wurde.

Gibt Folgendes zurück:
`IInvocationContext`	Die `IInvocationContext` des Moduls für einen bestimmten Testlaufnamen `null`, wenn keine Ergebnisse für diesen Namen vorhanden sind.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die dem Modul zugeordnet sind.

Gibt Folgendes zurück:
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die keinem Testlauf oder Modul zugeordnet sind.

Gibt Folgendes zurück:
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Gibt die Gesamtzahl der Testläufe mit dem Status „Fehler“ zurück.

Gibt Folgendes zurück:
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Gibt die Gesamtzahl der Tests mit dem Status „Fehler“ zurück. Annahmefehler werden nicht berücksichtigt.

Gibt Folgendes zurück:
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Gibt die Anzahl der Tests im angegebenen Status für diesen Lauf zurück.

Parameter
`status`	`TestStatus`

Gibt Folgendes zurück:
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Zur Kompatibilität mit dem alten Statustyp

Parameter
`ddmlibStatus`	`TestResult.TestStatus`

Gibt Folgendes zurück:
`int`

getNumTotalTests

public int getNumTotalTests ()

Gibt die Gesamtzahl der abgeschlossenen Tests für alle Läufe zurück.

Gibt Folgendes zurück:
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Gibt die primären Build-Informationen zurück, die über invocationStarted(IInvocationContext) gemeldet wurden. Der primäre Build ist der Build, der vom ersten Build-Anbieter der laufenden Konfiguration zurückgegeben wird. Gibt „null“ zurück, wenn kein Kontext vorhanden ist (kein Build für den Testlauf).

Gibt Folgendes zurück:
`IBuildInfo`

getRunResults

public Collection<TestRunResult> getRunResults ()

Diese Methode wurde eingestellt.
getMergedTestRunResults() verwenden

Gibt die Ergebnisse für alle Testläufe zurück.

Gibt Folgendes zurück:
`Collection<TestRunResult>`

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Gibt die TestRunResult für einen einzelnen Versuch zurück.

Parameter
`testRunName`	`String`: Der Name, der von {`testRunStarted(String,int)` angegeben wurde.
`attempt`	`int`: Die ID des Versuchs.

Gibt Folgendes zurück:
`TestRunResult`	Die `TestRunResult` für den angegebenen Namen und die angegebene Versuchs-ID oder `null`, wenn sie nicht vorhanden ist.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Gibt die Anzahl der Versuche für einen bestimmten Testlaufnamen zurück.

Parameter
`testRunName`	`String`: Der Name, der von {`testRunStarted(String,int)` angegeben wurde.

Gibt Folgendes zurück:
`int`

getTestRunAttempts

public List<TestRunResult> getTestRunAttempts (String testRunName)

Ruft alle Versuche für eine TestRunResult eines bestimmten Testlaufs ab.

Parameter
`testRunName`	`String`: Der Name, der von {`testRunStarted(String,int)` angegeben wurde.

Gibt Folgendes zurück:
`List<TestRunResult>`	Alle `TestRunResult` für einen bestimmten Testlauf, sortiert nach Versuchen.

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

Ruft alle Ergebnisse für einen bestimmten Versuch ab.

Parameter
`attempt`	`int`: Der Versuch, für den wir Ergebnisse erhalten möchten.

Gibt Folgendes zurück:
`List<TestRunResult>`	Alle `TestRunResult` für einen bestimmten Versuch.

getTestRunNames

public Collection<String> getTestRunNames ()

Gibt alle Namen für alle Testläufe zurück.

Diese Testläufe wurden möglicherweise mehrmals mit verschiedenen Versuchen ausgeführt.

Gibt Folgendes zurück:
`Collection<String>`

hasFailedTests

public boolean hasFailedTests ()

Gibt zurück, ob bei dem Aufruf Tests fehlgeschlagen sind oder Annahmen fehlgeschlagen sind.

Gibt Folgendes zurück:
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Gibt zurück, ob für einen bestimmten Testlaufname Ergebnisse vorhanden sind.

Parameter
`testRunName`	`String`: Der Name, der von {`testRunStarted(String,int)` angegeben wurde.

Gibt Folgendes zurück:
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`elapsedTime`	`long`: die verstrichene Zeit des Aufrufs in Millisekunden

invocationFailed

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`cause`	`Throwable`: die `Throwable`-Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung für mehrere Geräte zu unterstützen.

Parameter
`context`	`IInvocationContext`: Informationen zum Aufruf

isDisabled

public boolean isDisabled ()

Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (sowohl Einrichtung als auch Abbau werden übersprungen). Andernfalls „Falsch”.

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.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Diese Methode wurde eingestellt.
Nicht mehr für Tests erforderlich.

Legt die Build-Informationen fest. Sollte nur zum Testen verwendet werden.

Parameter
`buildInfo`	`IBuildInfo`

setDisable

public void setDisable (boolean isDisabled)

Legt fest, ob das Objekt deaktiviert werden soll. „Deaktiviert“ bedeutet, dass sowohl die Einrichtungs- als auch die Abbauvorgänge übersprungen werden sollen. Kann verwendet werden, um ein Objekt im Standardkonstruktor standardmäßig zu deaktivieren.

Parameter
`isDisabled`	`boolean`: Der Status, in den das Objekt versetzt werden soll.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Legt die MergeStrategy fest, die beim Zusammenführen von Ergebnissen verwendet werden soll.

Parameter
`strategy`	`MergeStrategy`

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, 
                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

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

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.

testModuleEnded

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls. Dieser Callback ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Runner.

Parameter
`moduleContext`	`IInvocationContext`: Die `IInvocationContext` des Moduls.

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)

Meldet den Beginn eines Testlaufs.

Parameter
`name`	`String`: der Name des Testlaufs
`numTests`	`int`: Gesamtzahl der Tests im Testlauf

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()`

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

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()`

testStarted

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(TestDescription).

Parameter
`test`	`TestDescription`: Gibt den Test an.

Geschützte Methoden

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Ermöglicht das Bereinigen der Moduldatei, damit sie nicht zu lange mitgeführt werden muss.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Ermöglicht das Löschen der Ergebnisse für einen bestimmten Laufnamen. Sollte nur in bestimmten Fällen verwendet werden, z. B. für die Zusammenfassung von Ergebnissen.

Parameter
`testRunName`	`String`

clearTestRunResults

protected final void clearTestRunResults ()

Ermöglicht das Löschen aller Testergebnisse, damit sie nicht zu lange gespeichert werden.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Option „Messwerte zusammenfassen“ ein- oder ausschalten

Parameter
`aggregate`	`boolean`