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 |
String | mangleTestRunName (String name) Diese Methode wird für alle Testlaufnamen ausgeführt, die an den |
Ö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 | 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 vorERROR(/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 | 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.
Parameter | |
---|---|
name | String |
Kehrt zurück | |
---|---|
String |