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.

ResultForwarder( listeners)

Erstellen Sie eine ResultForwarder.

Geschützte Konstruktoren

ResultForwarder()

Erstellen Sie eine ResultForwarder mit der Einstellung „Deferred 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(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, testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), bei der die Endzeit direkt angegeben werden kann.

void testEnded(TestDescription test, testMetrics)

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, runMetrics)

Gibt das Ende des Testlaufs an.

void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, nicht abgeschlossen werden.

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 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.

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( listeners)

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 ITestInvocationListeners, an die Ergebnisse weitergeleitet werden sollen

ResultForwarder

public ResultForwarder ( listeners)

Erstellen Sie eine ResultForwarder.

Parameter
listeners : die echten ITestInvocationListeners, 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

protected  getListeners ()

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 ITestInvocationListeners, 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 ITestInvocationListeners, an die Ergebnisse weitergeleitet werden sollen