SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

Bekannte direkte Unterklassen LegacySubprocessResultsReporter LegacySubprocessResultsReporter Eine eingefrorene Implementierung des Subprozess-Ergebnisreporters, die trotz Änderungen in ihrer Oberklasse mit früheren Versionen von TF/CTS (z. B. 8+) kompatibel bleiben sollte.

---

Implementiert ITestInvocationListener , um als result_reporter angegeben zu werden und vom Unterprozess die Ergebnisse von Tests, Testläufen und Testaufrufen weiterzuleiten.

Zusammenfassung

Öffentliche Bauträger
SubprocessResultsReporter ()

Öffentliche Methoden
void	close ()
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	logAssociation (String dataName, LogFile logFile) In einigen Fällen muss das Protokoll eng mit einem Testfall verknüpft sein, es besteht jedoch die Möglichkeit, dies direkt über testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Rückruf ist nicht möglich.
void	printEvent (String key, Object event) Helfer zum Drucken des Ereignisschlüssels und dann des JSON-Objekts.
void	setOutputTestLog (boolean outputTestLog) Legt fest, ob der protokollierte Test ausgegeben werden soll oder nicht.
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 Atomtest meldet, dass er eine falsche Bedingung annimmt
void	testAssumptionFailure ( TestDescription testId, FailureDescription failure) Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt
void	testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) wo wir die Endzeit direkt angeben können.
void	testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Meldet das Ausführungsende eines einzelnen Testfalls.
void	testFailed ( TestDescription testId, FailureDescription failure) Meldet den Fehler eines einzelnen Testfalls.
void	testFailed ( TestDescription testId, String reason) Meldet den Fehler eines einzelnen Testfalls.
void	testIgnored ( TestDescription testId) 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 time, runMetrics) testRunEnded (long time, runMetrics) Meldet das Ende des Testlaufs.
void	testRunFailed ( FailureDescription failure) Der Testlauf des Berichts konnte aufgrund eines in FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.
void	testRunFailed (String reason) 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 arg0) Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen.
void	testStarted ( TestDescription testId, 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 .
void	testStarted ( TestDescription testId) Meldet den Beginn eines einzelnen Testfalls.

Öffentliche Bauträger

SubprocessResultsReporter

public SubprocessResultsReporter ()

Öffentliche Methoden

schließen

public void close ()

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit einem Testfall verknüpft sein, es besteht jedoch die Möglichkeit, dies direkt über testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Rückruf ist nicht möglich. Somit ermöglicht dieser Rückruf die explizite Bereitstellung einer starken Assoziation.

Parameter
dataName	String : Der Name der Daten
logFile	LogFile : die LogFile , die zuvor protokolliert wurde und dem Testfall zugeordnet werden sollte.

printEvent

public void printEvent (String key, 
                Object event)

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

Parameter
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Legt fest, ob der protokollierte Test ausgegeben werden soll oder nicht.

Parameter
outputTestLog	boolean

supportGranularResults

public boolean supportGranularResults ()

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

Kehrt zurück
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

Parameter
testId	TestDescription : Identifiziert den Test
failure	FailureDescription : FailureDescription , die 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)) wo wir die Endzeit direkt angeben können. Für eine genaue Messung mit testStarted(com.android.tradefed.result.TestDescription, long) kombinieren.

Parameter
testId	TestDescription : Identifiziert den Test
endTime	long : Die Zeit, zu der der Test endete, gemessen über System.currentTimeMillis()
metrics	: ein ERROR(/Map) der ausgegebenen Metriken

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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
testId	TestDescription : Identifiziert den Test
metrics	: ein ERROR(/Map) der ausgegebenen Metriken

im Test durchgefallen

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Meldet den Fehler eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

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

im Test durchgefallen

public void testFailed (TestDescription testId, 
                String reason)

Meldet den Fehler eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

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

testIgnored

public void testIgnored (TestDescription testId)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, 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)

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

Muss vor ERROR(/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 time, 
                 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
time	long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden
runMetrics	: Schlüssel-Wert-Paare, die am Ende eines Testlaufs mit 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 reason)

Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
reason	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 arg0)

Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen.

TODO: derzeit nicht verwendet, erwägen Sie die Entfernung

Parameter
arg0	long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden

testgestartet

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

testgestartet

public void testStarted (TestDescription testId)

Meldet den Beginn eines einzelnen Testfalls. Bei älteren Schnittstellen sollte nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription) verwendet werden.

Parameter
testId	TestDescription : Identifiziert den Test