InvocationToJUnitResultForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.InvocationToJUnitResultForwarder

Bekannte direkte Unterklassen TextResultReporter TextResultReporter Ein Testresult-Reporter, der Ergebnisse an den JUnit-Textresult-Printer weiterleitet.

---

Eine Klasse, die auf ITestInvocationListener-Ereignisse wartet und sie an einen TestListener weiterleitet.

Zusammenfassung

Öffentliche Konstruktoren
InvocationToJUnitResultForwarder(TestListener junitListener)

Öffentliche Methoden
TestSummary	getSummary() Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.
void	invocationEnded(long elapsedTime) Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
void	invocationFailed(Throwable cause) Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
void	invocationStarted(IInvocationContext context) Meldet den Beginn des Testaufrufs.
void	testAssumptionFailure(TestDescription testId, String trace) Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) Meldet das Ende der Ausführung eines einzelnen Testlaufs.
void	testFailed(TestDescription testId, String trace) Meldet das Fehlschlagen 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 logData, InputStreamSource dataStream) Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.
void	testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics) Meldet das Ende des Testlaufs.
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 Beginn eines Testlaufs.
void	testRunStopped(long elapsedTime) Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.
void	testStarted(TestDescription test) Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
TestListener	getJUnitListener()

Öffentliche Konstruktoren

InvocationToJUnitResultForwarder

public InvocationToJUnitResultForwarder (TestListener junitListener)

Parameter
junitListener	TestListener

Öffentliche Methoden

getSummary

public TestSummary getSummary ()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

Gibt Folgendes zurück:
TestSummary	Eine TestSummary, die den Lauf zusammenfasst, oder „null“

invocationEnded

public void invocationEnded (long elapsedTime)

Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime	long: die verstrichene Zeit des Aufrufs in Millisekunden

invocationFailed

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

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 für mehrere Geräte zu unterstützen.

Parameter
context	IInvocationContext: Informationen zum Aufruf

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

Parameter
testId	TestDescription: Gibt den Test an.
trace	String: Stacktrace des Fehlers

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
test	TestDescription: Gibt den Test an.
testMetrics	HashMap: Map der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription testId, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
testId	TestDescription: Gibt den Test an.
trace	String: Stacktrace 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: Gibt den Test an.

testLog

public void testLog (String dataName, 
                LogDataType logData, 
                InputStreamSource dataStream)

Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.

Muss vor ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Log und gegebenenfalls das Geräte-Logcat bereit.

Parameter
dataName	String: Ein String aussagekräftiger Name der Daten, z. B. „device_logcat“. Hinweis: dataName ist möglicherweise nicht pro Aufruf eindeutig. Implementierer müssen also mehrere Aufrufe mit demselben dataName verarbeiten können.
logData	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 schließen, wenn sie fertig sind. Anrufer sollten dafür sorgen, dass die Datenquelle bis zum Abschluss der Methode „testLog“ vorhanden und zugänglich bleibt.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichen Typen haben, daher müssen wir hier HashMap verwenden.

Parameter
elapsedTime	long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
runMetrics	HashMap: Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit Metric 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, in dem der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Beginn eines Testlaufs.

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 vor dem Abschluss beendet.

TODO: currently unused, consider removing

Parameter
elapsedTime	long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

testStarted

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(TestDescription).

Parameter
test	TestDescription: Gibt den Test an.

Geschützte Methoden

getJUnitListener

protected TestListener getJUnitListener ()

Gibt Folgendes zurück:
TestListener