SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Bekannte direkte abgeleitete Klassen LegacySubprocessResultsReporter LegacySubprocessResultsReporter Eine eingefrorene Implementierung des subprocess results reporters, die trotz Änderungen an der Superklasse mit früheren Versionen von TF/CTS (z.B. 8+) kompatibel bleiben sollte.

---

Implementiert ITestInvocationListener, um als „result_reporter“ angegeben zu werden, und leitet die Ergebnisse von Tests, Testläufen und Testaufrufen aus dem untergeordneten Prozess weiter.

Zusammenfassung

Öffentliche Konstruktoren
SubprocessResultsReporter()

Öffentliche Methoden
void	close()
TestSummary	getSummary() Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.
void	invocationEnded(long elapsedTime) Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund einer Fehlerbedingung.
void	invocationFailed(FailureDescription failure) Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung.
void	invocationFailed(Throwable cause) Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
void	invocationStarted(IInvocationContext context) Gibt den Beginn der Testausführung an.
void	logAssociation(String dataName, LogFile logFile) In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist.
void	printEvent(String key, Object event) Hilft beim Drucken des Ereignisschlüssels und dann des JSON-Objekts.
void	setOutputTestLog(boolean outputTestLog) Legt fest, ob die Testprotokolle ausgegeben werden sollen.
boolean	supportGranularResults() Gibt "True" zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls "False".
void	testAssumptionFailure(TestDescription testId, String trace) Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
void	testAssumptionFailure(TestDescription testId, FailureDescription failure) Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
void	testEnded(TestDescription testId, long endTime, metrics) Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können.
void	testEnded(TestDescription testId, metrics) Gibt das Ende der Ausführung eines einzelnen Testfalls an.
void	testFailed(TestDescription testId, FailureDescription failure) Meldet das Scheitern eines einzelnen Testlaufs.
void	testFailed(TestDescription testId, String reason) Hier wird der Fehler eines einzelnen Testfalls gemeldet.
void	testIgnored(TestDescription testId) Wird aufgerufen, wenn ein Test nicht ausgeführt wird. Dies ist im Allgemeinen der Fall, weil eine Testmethode mit org.junit.Ignorieren annotiert ist.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
void	testModuleEnded() Gibt das Ende eines Modullaufs an.
void	testModuleStarted(IInvocationContext moduleContext) Gibt den Beginn der Ausführung eines Moduls an.
void	testRunEnded(long time, 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 reason) Der Testlauf für Berichte 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) Gibt den Beginn eines Testlaufs an.
void	testRunStopped(long arg0) Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss gestoppt.
void	testSkipped(TestDescription testId, SkipReason reason) Wird aufgerufen, wenn ein Test übersprungen und aus einem normalerweise nicht erwarteten Grund nicht ausgeführt wurde.
void	testStarted(TestDescription testId, 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 testId) Gibt den Beginn eines einzelnen Testfalls an.

Öffentliche Konstruktoren

SubprocessResultsReporter

public SubprocessResultsReporter ()

Öffentliche Methoden

Schließen

public void close ()

getSummary

public TestSummary getSummary ()

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

Returns
TestSummary	Eine TestSummary, die den Lauf zusammenfasst, 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 seit der Aufrufung in ms

invocationFailed

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

callStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

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 zum Aufruf

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist. So kann mit diesem Rückruf eine starke Verknüpfung explizit angegeben werden.

Parameter
dataName	String: Der Name der Daten
logFile	LogFile: die LogFile, die zuvor protokolliert wurde und mit dem Testfall verknüpft werden soll.

printEvent

public void printEvent (String key, 
                Object event)

Hilfsprogramm zum Drucken des Ereignisschlüssels und dann des JSON-Objekts.

Parameter
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Legt fest, ob die Testprotokolle ausgegeben werden sollen.

Parameter
outputTestLog	boolean

supportGranularResults

public boolean supportGranularResults ()

Gibt „True“ zurück, wenn der Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“.

Returns
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
testId	TestDescription: Identifiziert den Test
trace	String: Stack-Trace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
testId	TestDescription: Identifiziert den Test
failure	FailureDescription: FailureDescription, der den Fehler und seinen Kontext beschreibt.

testEnded

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. In Kombination mit testStarted(com.android.tradefed.result.TestDescription, long) erhalten Sie eine genaue Messung.

Parameter
testId	TestDescription: identifiziert den Test
endTime	long: die Zeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis()
metrics	: ein ERROR(/Map) der ausgegebenen Messwerte

TestBeendet

public void testEnded (TestDescription testId, 
                 metrics)

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
testId	TestDescription: identifiziert den Test
metrics	: ERROR(/Map) der gesendeten Messwerte

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
testId	TestDescription: Identifiziert den Test
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testFailed

public void testFailed (TestDescription testId, 
                String reason)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
testId	TestDescription: Identifiziert den Test
reason	String: Stack-Trace des Fehlers

testIgnoriert

public void testIgnored (TestDescription testId)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel weil eine Testmethode mit org.junit.Ignore annotiert ist.

Parameter
testId	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. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss 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 während einer Ausführung mit Modulen verwendet, also Suite-basierten Runnern.

Parameter
moduleContext	IInvocationContext: die IInvocationContext des Moduls.

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Gibt das Ende des Testlaufs an.

Parameter
time	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

public void testRunFailed (String reason)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
reason	String: String mit einer Beschreibung des Grunds für den Ausführungsfehler.

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: 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)

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: Bestellnummer, die die verschiedenen Versuche desselben runName-Elements identifiziert, die mehrmals ausgeführt werden 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 arg0)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss gestoppt.

TODO: currently unused, consider removing

Parameter
arg0	long: Gerät hat die verstrichene Zeit in Millisekunden gemeldet

testSkipped

public void testSkipped (TestDescription testId, 
                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
testId	TestDescription: Identifiziert den Test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription testId, 
                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
testId	TestDescription: identifiziert den Test
startTime	long: Der Zeitpunkt, zu dem der Test gestartet wurde, gemessen über System.currentTimeMillis()

testStarted

public void testStarted (TestDescription testId)

Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
testId	TestDescription: identifiziert den Test