ResultForwarder
public
class
ResultForwarder
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
Ein ITestInvocationListener
, der Aufrufergebnisse an eine Liste anderer Listener weiterleitet.
Zusammenfassung
Öffentliche Konstruktoren | |
---|---|
ResultForwarder(ITestInvocationListener... listeners)
Alternativer Variablenargumentkonstruktor für |
|
ResultForwarder(
Erstellen Sie eine |
Geschützte Konstruktoren | |
---|---|
ResultForwarder()
Erstellen Sie eine |
Ö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(FailureDescription failure)
Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet. |
void
|
invocationFailed(Throwable cause)
Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet. |
void
|
invocationSkipped(SkipReason reason)
Eine Aufrufe wird als übersprungen gemeldet |
void
|
invocationStarted(IInvocationContext context)
Gibt den Beginn der Testausführung an. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist. |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist |
void
|
testEnded(TestDescription test, long endTime,
Alternative zu |
void
|
testEnded(TestDescription test,
Gibt das Ende der Ausführung eines einzelnen Testfalls an. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
void
|
testFailed(TestDescription test, String trace)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
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)
Stellt die zugehörigen Log- oder Debug-Daten aus dem Testaufruf bereit. |
void
|
testModuleEnded()
Meldet das Ende einer Modulausführung. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Gibt den Beginn der Ausführung eines Moduls an. |
void
|
testRunEnded(long elapsedTime,
Gibt das Ende des Testlaufs an. |
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von |
void
|
testRunFailed(String errorMessage)
Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Gibt den Beginn eines Testlaufs an. |
void
|
testRunStarted(String runName, int testCount)
Gibt den Beginn eines Testlaufs an. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Gibt den Beginn eines Testlaufs an. |
void
|
testRunStopped(long elapsedTime)
Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet. |
void
|
testSkipped(TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen und aus einem normalerweise nicht erwarteten Grund nicht ausgeführt wurde. |
void
|
testStarted(TestDescription test, long startTime)
Alternative zu |
void
|
testStarted(TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. |
Geschützte Methoden | |
---|---|
|
getListeners()
Liste der Zuhörer abrufen |
void
|
setListeners(ITestInvocationListener... listeners)
Legen Sie die Listener nach dem Erstellen fest. |
void
|
setListeners(
Legen Sie die Listener nach dem Erstellen fest. |
Öffentliche Konstruktoren
ResultForwarder
public ResultForwarder (ITestInvocationListener... listeners)
Alternativer Variablenargumentkonstruktor für ResultForwarder
.
Parameter | |
---|---|
listeners |
ITestInvocationListener : die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
ResultForwarder
public ResultForwarder (listeners)
Erstellen Sie eine ResultForwarder
.
Parameter | |
---|---|
listeners |
: die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
Geschützte Konstruktoren
ResultForwarder
protected ResultForwarder ()
Erstellen Sie eine ResultForwarder
mit der Einstellung „Deferred Listener“. Nur für die Verwendung durch Unterklassen vorgesehen.
Öffentliche Methoden
getSummary
public TestSummary getSummary ()
Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.
Returns | |
---|---|
TestSummary |
Ein TestSummary für die Zusammenfassung der Ausführung oder null |
invocationEnded
public void invocationEnded (long elapsedTime)
Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.
Wird automatisch vom TradeFederation-Framework aufgerufen.
Parameter | |
---|---|
elapsedTime |
long : die verstrichene Zeit des Aufrufs in ms |
CallFailed (Aufruf fehlgeschlagen)
public void invocationFailed (FailureDescription failure)
Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
Wird automatisch vom TradeFederation-Framework aufgerufen.
Parameter | |
---|---|
failure |
FailureDescription : die FailureDescription , die die Ursache des Fehlers beschreibt |
invocationFailed
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 |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Eine Aufrufe wird als übersprungen gemeldet
Parameter | |
---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
Gibt den Beginn der Testausführung an.
Wird automatisch vom TradeFederation-Framework aufgerufen. Meldende müssen diese Methode überschreiben, um Berichte zu mehreren Geräten zu unterstützen.
Parameter | |
---|---|
context |
IInvocationContext : Informationen zur Aufrufung |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
trace |
String : Stack-Trace des Fehlers |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
failure |
FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, mit der wir die Endzeit direkt angeben können. Kombinieren Sie diesen Messwert mit testStarted(com.android.tradefed.result.TestDescription, long)
, um genaue Ergebnisse zu erhalten.
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
endTime |
long : die Zeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) der gesendeten Messwerte |
testEnded
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 |
: ein ERROR(/Map) der ausgegebenen Messwerte |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Hier wird der Fehler eines einzelnen Testfalls gemeldet.
Wird zwischen testStarted und testEnded aufgerufen.
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
failure |
FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt. |
TestFehlgeschlagen
public void testFailed (TestDescription test, String trace)
Hier wird der Fehler eines einzelnen Testfalls gemeldet.
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 |
testLog
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 beschreibender String -Name der 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. Die Aufrufer müssen dafür sorgen, dass die Datenquelle bis zum Abschluss der testLog-Methode vorhanden und zugänglich ist. |
testModuleEnded
public void testModuleEnded ()
Gibt das Ende eines Modullaufs an.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Gibt den Beginn der Ausführung eines Moduls an. Dieser Rückruf ist mit testModuleEnded()
verknüpft und in der Abfolge optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Auslöser.
Parameter | |
---|---|
moduleContext |
IInvocationContext : die IInvocationContext des Moduls. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Gibt das Ende des Testlaufs an.
Parameter | |
---|---|
elapsedTime |
long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
runMetrics |
: Schlüssel/Wert-Paare, die am Ende eines Testlaufs erfasst werden |
testRunFailed
public void testRunFailed (FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription
beschrieben wurde, nicht abgeschlossen werden.
Parameter | |
---|---|
failure |
FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt. |
testRunFailed (Testlauf fehlgeschlagen)
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, int attemptNumber)
Gibt den Beginn eines Testlaufs an.
Parameter | |
---|---|
runName |
String : der Name der Testausführung |
testCount |
int : Gesamtzahl der Tests im Testlauf |
attemptNumber |
int : Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe mit demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Gibt den Beginn eines Testlaufs an.
Parameter | |
---|---|
runName |
String : der Name der Testausführung |
testCount |
int : Gesamtzahl der Tests im Testlauf |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Gibt den Beginn eines Testlaufs an.
Parameter | |
---|---|
runName |
String : der Name der Testausführung |
testCount |
int : Gesamtzahl der Tests im Testlauf |
attemptNumber |
int : Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe unter demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen. |
startTime |
long : Der Zeitpunkt, zu dem die Ausführung gestartet wurde, gemessen über System.currentTimeMillis() |
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 |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. Diese Tests werden wiederholt, um eine korrekte Ausführung zu erreichen.
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternative zu testStarted(com.android.tradefed.result.TestDescription)
, bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
kombiniert, um genaue Messungen zu ermöglichen.
Parameter | |
---|---|
test |
TestDescription : identifiziert den Test |
startTime |
long : Der Zeitpunkt, zu dem der Test gestartet wurde, gemessen über System.currentTimeMillis() |
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
getListeners
protectedgetListeners ()
Liste der Zuhörer abrufen Nur für Unterklassen gedacht.
Returns | |
---|---|
|
Die Liste der ITestInvocationListener . |
SetListener
protected void setListeners (ITestInvocationListener... listeners)
Legen Sie die Listener nach dem Erstellen fest. Nur für Unterklassen gedacht.
Parameter | |
---|---|
listeners |
ITestInvocationListener : die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
SetListener
protected void setListeners (listeners)
Legen Sie die Listener nach dem Erstellen fest. Nur für Unterklassen gedacht.
Parameter | |
---|---|
listeners |
: die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |