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 Bauträger | |
---|---|
ResultForwarder ( listeners) ResultForwarder ( listeners) Erstellen Sie einen | |
ResultForwarder ( ITestInvocationListener... listeners) Alternativer Variablen-Arg-Konstruktor für |
Geschützte Konstrukteure | |
---|---|
ResultForwarder () Erstellen Sie einen |
Ö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 ( FailureDescription failure) Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung. |
void | invocationFailed (Throwable cause) Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung. |
void | invocationStarted ( IInvocationContext context) Meldet den Beginn des Testaufrufs. |
void | testAssumptionFailure ( TestDescription test, String trace) Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternative zu |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Meldet das Ausführungsende eines einzelnen Testfalls. |
void | testFailed ( TestDescription test, FailureDescription failure) Meldet den Fehler eines einzelnen Testfalls. |
void | testFailed ( TestDescription test, String trace) Meldet den Fehler 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 annotiert ist. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit. |
void | testModuleEnded () Meldet das Ende eines Modullaufs. |
void | testModuleStarted ( IInvocationContext moduleContext) Meldet den Beginn der Ausführung eines Moduls. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Meldet das Ende des Testlaufs. |
void | testRunFailed ( FailureDescription failure) Der Testlauf des Berichts konnte aufgrund eines in |
void | testRunFailed (String errorMessage) Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Meldet den Start eines Testlaufs. |
void | testRunStarted (String runName, int testCount) Meldet den Start eines Testlaufs. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Meldet den Start eines Testlaufs. |
void | testRunStopped (long elapsedTime) Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen. |
void | testStarted ( TestDescription test, long startTime) Alternative zu |
void | testStarted ( TestDescription test) Meldet den Beginn eines einzelnen Testfalls. |
Geschützte Methoden | |
---|---|
getListeners () Rufen Sie die Liste der Zuhörer ab. | |
void | setListeners ( ITestInvocationListener... listeners) Stellen Sie die Zuhörer nach der Konstruktion ein. |
void | setListeners ( listeners) setListeners ( listeners) Stellen Sie die Zuhörer nach der Konstruktion ein. |
Öffentliche Bauträger
ResultForwarder
public ResultForwarder (listeners)
Erstellen Sie einen ResultForwarder
.
Parameter | |
---|---|
listeners | ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
ResultForwarder
public ResultForwarder (ITestInvocationListener... listeners)
Alternativer Variablen-Arg-Konstruktor für ResultForwarder
.
Parameter | |
---|---|
listeners | ITestInvocationListener : die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
Geschützte Konstrukteure
ResultForwarder
protected ResultForwarder ()
Erstellen Sie einen ResultForwarder
mit der Einstellung „Deferred Listener“. Nur für die Verwendung durch Unterklassen vorgesehen.
Ö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 |
invocationEnded
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 (FailureDescription failure)
Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung.
Wird automatisch vom TradeFederation-Framework aufgerufen.
Parameter | |
---|---|
failure | FailureDescription : Die FailureDescription , die die Ursache des Fehlers beschreibt |
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 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, um die Berichterstellung über mehrere Geräte zu unterstützen.
Parameter | |
---|---|
context | IInvocationContext : Informationen zum Aufruf |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt
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 er eine falsche Bedingung annimmt
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))
wo wir die Endzeit direkt angeben können. Für eine genaue Messung mit testStarted(com.android.tradefed.result.TestDescription, long)
kombinieren.
Parameter | |
---|---|
test | TestDescription : Identifiziert den Test |
endTime | long : Die Zeit, zu der der Test endete, gemessen über System.currentTimeMillis() |
testMetrics | ERROR(/Map) der ausgegebenen Metriken |
testEnded
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 außerdem alle Schlüssel-/Wertmetriken 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, FailureDescription failure)
Meldet den Fehler eines einzelnen Testfalls.
Wird zwischen testStarted und testEnded aufgerufen.
Parameter | |
---|---|
test | TestDescription : Identifiziert den Test |
failure | FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt. |
im Test durchgefallen
public void testFailed (TestDescription test, String trace)
Meldet den Fehler eines einzelnen Testfalls.
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, im Allgemeinen, 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)
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 String der den Namen der Daten beschreibt. zB „device_logcat“. Beachten Sie, dass dataName pro Aufruf möglicherweise nicht eindeutig ist. Das heißt, Implementierer müssen in der Lage sein, mehrere Aufrufe mit demselben Datennamen 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 Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist. |
testModuleEnded
public void testModuleEnded ()
Meldet das Ende eines Modullaufs.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Meldet den Beginn der Ausführung eines Moduls. Dieser Rückruf ist mit testModuleEnded()
verknüpft und in der Sequenz optional. Es wird nur während eines Laufs verwendet, der Module verwendet: Suite-basierte Läufer.
Parameter | |
---|---|
moduleContext | IInvocationContext : der IInvocationContext des Moduls. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichem Typ haben, daher 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 (FailureDescription failure)
Der Testlauf des Berichts konnte aufgrund eines in FailureDescription
beschriebenen Fehlers nicht abgeschlossen werden.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt. |
testRunFailed
public void testRunFailed (String errorMessage)
Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
Parameter | |
---|---|
errorMessage | String : String , der den Grund für den Ausführungsfehler beschreibt. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Meldet den Start eines Testlaufs.
Parameter | |
---|---|
runName | String : der Name des Testlaufs |
testCount | int : Gesamtzahl der Tests im Testlauf |
attemptNumber | int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jedem neuen Lauf erhöht werden. Beispielsweise wird ein Test granular dreimal wiederholt, es sollten insgesamt 4 Ausführungen unter demselben runName erfolgen und die Versuchsnummer liegt zwischen 0 und 3. |
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 |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Meldet den Start eines Testlaufs.
Parameter | |
---|---|
runName | String : der Name des Testlaufs |
testCount | int : Gesamtzahl der Tests im Testlauf |
attemptNumber | int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jedem neuen Lauf erhöht werden. Beispielsweise wird ein Test granular dreimal wiederholt, es sollten insgesamt 4 Ausführungen unter demselben runName erfolgen und die Versuchsnummer liegt zwischen 0 und 3. |
startTime | long : Die Zeit, zu der der Lauf gestartet wurde, gemessen über System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen.
TODO: derzeit nicht verwendet, erwägen Sie die Entfernung
Parameter | |
---|---|
elapsedTime | long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
testgestartet
public void testStarted (TestDescription test, long startTime)
Alternative zu testStarted(com.android.tradefed.result.TestDescription)
, wo wir auch angeben, wann der Test gestartet wurde, kombiniert mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
für eine genaue Messung .
Parameter | |
---|---|
test | TestDescription : Identifiziert den Test |
startTime | long : Die Zeit, zu der der Test gestartet wurde, gemessen über System.currentTimeMillis() |
testgestartet
public void testStarted (TestDescription test)
Meldet den Beginn eines einzelnen Testfalls. Bei älteren Schnittstellen sollte nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription)
verwendet werden.
Parameter | |
---|---|
test | TestDescription : Identifiziert den Test |
Geschützte Methoden
getListeners
protectedgetListeners ()
Rufen Sie die Liste der Zuhörer ab. Nur für die Verwendung durch Unterklassen vorgesehen.
Kehrt zurück | |
---|---|
Die Liste der ITestInvocationListener s. |
setListeners
protected void setListeners (ITestInvocationListener... listeners)
Stellen Sie die Zuhörer nach der Konstruktion ein. Nur für die Verwendung durch Unterklassen vorgesehen.
Parameter | |
---|---|
listeners | ITestInvocationListener : die echten ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |
setListeners
protected void setListeners (listeners)
Stellen Sie die Zuhörer nach der Konstruktion ein. Nur für die Verwendung durch Unterklassen vorgesehen.
Parameter | |
---|---|
listeners | ITestInvocationListener s, an die Ergebnisse weitergeleitet werden sollen |