NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.NameMangleListener


Ein Proxy-Listener zum Übersetzen von Testmethoden-, Klassen- und Paketnamen, wenn Ergebnisse gemeldet werden.

Zusammenfassung

Öffentliche Konstrukteure

NameMangleListener ( ITestInvocationListener listener)

Öffentliche Methoden

TestSummary getSummary ()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf erfolgreich oder aufgrund einer Fehlerbedingung beendet wurde.

void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung.

void invocationStarted ( IInvocationContext context)

Meldet den Start des Testaufrufs.

void testAssumptionFailure ( TestDescription test, String trace)

Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Meldet das Ausführungsende eines einzelnen Testfalls.

void testFailed ( TestDescription test, String trace)

Meldet das Fehlschlagen eines einzelnen Testfalls.

void testIgnored ( TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore kommentiert ist.

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

Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Meldet das Ende des Testlaufs.

void testRunFailed (String errorMessage)

Berichtstestlauf konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

void testRunStarted (String runName, int testCount)

Meldet den Start eines Testlaufs.

void testRunStopped (long elapsedTime)

Berichtet, dass der Testlauf aufgrund einer Benutzeranforderung vor Abschluss beendet wurde.

void testStarted ( TestDescription test)

Meldet den Start eines einzelnen Testfalls.

Geschützte Methoden

TestDescription mangleTestId ( TestDescription test)

Diese Methode wird für alle TestDescription s ausgeführt, die an testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) und ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) Rückrufe.

String mangleTestRunName (String name)

Diese Methode wird für alle Testlaufnamen ausgeführt, die an den testRunStarted(String, int) -Rückruf übergeben werden.

Öffentliche Konstrukteure

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parameter
listener ITestInvocationListener

Öffentliche Methoden

getSummary

public TestSummary getSummary ()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

Kehrt zurück
TestSummary Eine TestSummary , die den Lauf zusammenfasst, oder null

AufrufBeendet

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf erfolgreich oder aufgrund einer Fehlerbedingung beendet wurde.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long : die verstrichene Zeit des Aufrufs in ms

Aufruf fehlgeschlagen

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
cause Throwable : die Fehlerursache ERROR(/Throwable)

AufrufStarted

public void invocationStarted (IInvocationContext context)

Meldet den Start des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Melder müssen diese Methode überschreiben, um die Meldung mehrerer Geräte zu unterstützen.

Parameter
context IInvocationContext : Informationen über den Aufruf

TestAnnahmeFehler

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt

Parameter
test TestDescription : identifiziert den Test

trace String : Stack-Trace des Fehlers

testBeendet

public void testEnded (TestDescription test, 
                 testMetrics)

Meldet das Ausführungsende eines einzelnen Testfalls.

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

Parameter
test TestDescription : identifiziert den Test

testMetrics : ein ERROR(/Map) der ausgegebenen Metriken

im Test durchgefallen

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
test TestDescription : identifiziert den Test

trace String : Stack-Trace des Fehlers

testIgnoriert

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore kommentiert ist.

Parameter
test TestDescription : identifiziert den Test

testLog

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

Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

Muss vor ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Protokoll und gegebenenfalls das Geräte-Logcat bereit.

Parameter
dataName String : ein ERROR(/String) beschreibender Name der Daten. zB "device_logcat". Hinweis dataName darf pro Aufruf nicht eindeutig sein. dh Implementierer müssen in der Lage sein, mehrere Aufrufe mit demselben dataName zu verarbeiten

dataType LogDataType : der LogDataType der Daten

dataStream InputStreamSource : die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und sicherstellen, dass der resultierende InputStream nach Abschluss geschlossen wird. Aufrufer sollten sicherstellen, dass die Quelle der Daten vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : Schlüssel-Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden.

testRunFailed

public void testRunFailed (String errorMessage)

Berichtstestlauf konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage String : ERROR(/String) beschreibt den Grund für den Ausführungsfehler.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Start eines Testlaufs.

Parameter
runName String : der Name des Testlaufs

testCount int : Gesamtzahl der Tests im Testlauf

testRunStopped

public void testRunStopped (long elapsedTime)

Berichtet, dass der Testlauf aufgrund einer Benutzeranforderung vor Abschluss beendet wurde.

TODO: Derzeit nicht verwendet, erwägen Sie das Entfernen

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

testGestartet

public void testStarted (TestDescription test)

Meldet den Start eines einzelnen Testfalls. Ältere Schnittstellen sollten nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription) verwenden.

Parameter
test TestDescription : identifiziert den Test

Geschützte Methoden

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Diese Methode wird für alle TestDescription s ausgeführt, die an testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) und ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) Rückrufe. Die Methode sollte eine möglicherweise andere TestDescription zurückgeben, die an den Downstream- ITestInvocationListener übergeben wird, der während der Konstruktion angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, dass die ursprüngliche TestDescription nicht geändert wird.

Die Standardimplementierung leitet den eingehenden Bezeichner unverändert weiter.

Parameter
test TestDescription

Kehrt zurück
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

Diese Methode wird für alle Testlaufnamen ausgeführt, die an den testRunStarted(String, int) -Rückruf übergeben werden. Die Methode sollte einen möglicherweise anderen Testlaufnamen zurückgeben, der an den nachgelagerten ITestInvocationListener übergeben wird, der während der Konstruktion angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, dass der ursprüngliche Ausführungsname nicht geändert wird.

Die Standardimplementierung übergibt den eingehenden Testlaufnamen unverändert.

Parameter
name String

Kehrt zurück
String