NameMangleListener
public
abstract
class
NameMangleListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.NameMangleListener |
Ein Proxy-Listener, der Testmethode, Klasse und Paketnamen bei der Berichterstellung übersetzt.
Zusammenfassung
Öffentliche Konstruktoren | |
---|---|
NameMangleListener(ITestInvocationListener listener)
|
Öffentliche Methoden | |
---|---|
TestSummary
|
getSummary()
Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben. |
void
|
invocationEnded(long elapsedTime)
Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden. |
void
|
invocationFailed(Throwable cause)
Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung. |
void
|
invocationStarted(IInvocationContext context)
Gibt den Beginn der Testausführung an. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist |
void
|
testEnded(TestDescription test,
Gibt das Ende der Ausführung eines einzelnen Testfalls an. |
void
|
testFailed(TestDescription test, String trace)
Meldet das Scheitern 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)
Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung. |
void
|
testRunEnded(long elapsedTime,
Gibt das Ende des Testlaufs an. |
void
|
testRunFailed(String errorMessage)
Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden. |
void
|
testRunStarted(String runName, int testCount)
Meldet den Start eines Testlaufs. |
void
|
testRunStopped(long elapsedTime)
Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss gestoppt. |
void
|
testStarted(TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. |
Geschützte Methoden | |
---|---|
TestDescription
|
mangleTestId(TestDescription test)
Diese Methode wird für alle |
String
|
mangleTestRunName(String name)
Diese Methode wird für alle Namen von Testläufen ausgeführt, die an den |
Öffentliche Konstruktoren
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parameter | |
---|---|
listener |
ITestInvocationListener |
Öffentliche Methoden
getSummary
public TestSummary getSummary ()
Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.
Returns | |
---|---|
TestSummary |
Eine TestSummary , die den Lauf zusammenfasst, oder „null“ |
Aufrufende beendet
public void invocationEnded (long elapsedTime)
Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund einer Fehlerbedingung.
Wird automatisch vom TradeFederation-Framework aufgerufen.
Parameter | |
---|---|
elapsedTime |
long : die verstrichene Zeit seit der Aufrufung in ms |
CallFailed (Aufruf fehlgeschlagen)
public void invocationFailed (Throwable cause)
Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
Wird automatisch vom TradeFederation-Framework aufgerufen.
Parameter | |
---|---|
cause |
Throwable : die Throwable -Ursache des Fehlers |
invocationStarted
public void invocationStarted (IInvocationContext context)
Meldet den Beginn des Testaufrufs.
Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, damit die Berichterstellung für mehrere Geräte unterstützt wird.
Parameter | |
---|---|
context |
IInvocationContext : Informationen zur Aufrufung |
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 : Stacktrace des Fehlers |
TestBeendet
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, String trace)
Meldet das Scheitern eines einzelnen Testlaufs.
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 |
Test-Log
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
Muss vor dem ERROR(/ITestInvocationListener#invocationFailed(Throwable))
oder ERROR(/ITestInvocationListener#invocationEnded(long))
aufgerufen werden
Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Hostprotokoll und gegebenenfalls das Geräte-Logcat bereit.
Parameter | |
---|---|
dataName |
String : Ein String aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis:
Der Datenname muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten. |
dataType |
LogDataType : die LogDataType der Daten |
dataStream |
InputStreamSource : die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss des Vorgangs schließen. Aufrufer sollten dafür sorgen, dass die Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Gibt das Ende des Testlaufs an.
Parameter | |
---|---|
elapsedTime |
long : Gerät hat die verstrichene Zeit in Millisekunden gemeldet |
runMetrics |
: Schlüssel/Wert-Paare, die am Ende eines Testlaufs gemeldet werden |
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 runName, int testCount)
Gibt den Beginn eines Testlaufs an.
Parameter | |
---|---|
runName |
String : der Name des Testlaufs |
testCount |
int : Gesamtzahl der Tests im Testlauf |
testRunStopped
public void testRunStopped (long elapsedTime)
Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.
TODO: currently unused, consider removing
Parameter | |
---|---|
elapsedTime |
long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
testgestartet
public void testStarted (TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription)
.
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
Geschützte Methoden
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Diese Methode wird für alle TestDescription
ausgeführt, die an die Rückrufe testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
und ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
übergeben werden. Die Methode sollte eine möglicherweise andere TestDescription
zurückgeben, die an die nachgelagerte ITestInvocationListener
übergeben wird, die während der Erstellung angegeben wurde.
Bei der Implementierung sollte darauf geachtet werden, die ursprüngliche TestDescription
nicht zu ändern.
Bei der Standardimplementierung wird die eingehende Kennung unverändert übergeben.
Parameter | |
---|---|
test |
TestDescription |
Returns | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
Diese Methode wird für alle Namen von Testläufen ausgeführt, die an den testRunStarted(String, int)
-Callback übergeben werden. Die Methode sollte einen möglicherweise anderen Namen für den Testlauf zurückgeben, der an die nachgelagerte ITestInvocationListener
übergeben wird, die während der Erstellung angegeben wurde.
Bei der Implementierung sollte darauf geachtet werden, den ursprünglichen Ausführungsnamen nicht zu ändern.
Die Standardimplementierung übergibt den Namen des eingehenden Testlaufs unverändert.
Parameter | |
---|---|
name |
String |
Returns | |
---|---|
String |