SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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


Implementiert ITestInvocationListener zur Angabe als result_reporter und zur Weiterleitung von dem Unterprozess die Ergebnisse von Tests, Testläufen und Testaufrufen.

Zusammenfassung

Öffentliche Konstruktoren

SubprocessResultsReporter()

Öffentliche Methoden

void close()

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund eines Fehlers .

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 Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich.

void printEvent(String key, Object event)

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

void setOutputTestLog(boolean outputTestLog)

Legt fest, ob der Test protokolliert 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 eine Bedingung falsch ist

void testAssumptionFailure(TestDescription testId, FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist

void testEnded(TestDescription testId, long endTime, metrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), wobei das Ende angegeben werden kann .

void testEnded(TestDescription testId, metrics)

Meldet das Ausführungsende eines einzelnen Testlaufs.

void testFailed(TestDescription testId, FailureDescription failure)

Meldet das Scheitern eines einzelnen Testlaufs.

void testFailed(TestDescription testId, String reason)

Meldet das Scheitern eines einzelnen Testlaufs.

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.

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)

Meldet den Beginn eines laufenden Moduls.

void testRunEnded(long time, runMetrics)

Ende des Testlaufs für Berichte.

void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines von FailureDescription beschriebenen Fehlers 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)

Meldet den Start eines Testlaufs.

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), wobei auch der Zeitpunkt des Tests angegeben wird gestartet, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung.

void testStarted(TestDescription testId)

Meldet den Beginn eines einzelnen Testlaufs.

Öffentliche Konstruktoren

SubprocessResultsReporter

public SubprocessResultsReporter ()

Öffentliche Methoden

Schließen

public void close ()

GetSummary

public TestSummary getSummary ()

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

Returns
TestSummary Ein TestSummary für die Zusammenfassung der Ausführung oder null

Aufrufende beendet

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund eines Fehlers .

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long: die verstrichene Zeit des Aufrufs in ms

CallFailed (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

CallFailed (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

callStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen die um Berichte für mehrere Geräte zu erstellen.

Parameter
context IInvocationContext: Informationen zum Aufruf

LogAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich. Dieser Callback ermöglicht also eine starke Assoziation explizit auf.

Parameter
dataName String: der Name der Daten

logFile LogFile: LogFile, die zuvor protokolliert wurde und mit dem Testfall.

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 der Test protokolliert werden soll oder nicht.

Parameter
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

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

Returns
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist

Parameter
testId TestDescription: Identifiziert den Test

trace String: Stacktrace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist

Parameter
testId TestDescription: Identifiziert den Test

failure FailureDescription: FailureDescription, der den Fehler und seinen Kontext beschreibt.

TestBeendet

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

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), wobei das Ende angegeben werden kann . 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)

Meldet das Ausführungsende eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, ist dieser Test erfolgreich. Gibt auch beliebige Schlüssel/Wert-Paare zurück Messwerte, die möglicherweise während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
testId TestDescription: Identifiziert den Test

metrics : ein ERROR(/Map) der ausgegebenen Messwerte

TestFehlgeschlagen

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Meldet das Scheitern eines einzelnen Testlaufs.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
testId TestDescription: Identifiziert den Test

failure FailureDescription: FailureDescription, der den Fehler und seinen Kontext beschreibt.

TestFehlgeschlagen

public void testFailed (TestDescription testId, 
                String reason)

Meldet das Scheitern eines einzelnen Testlaufs.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
testId TestDescription: Identifiziert den Test

reason String: Stacktrace des Fehlers

testIgnoriert

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

Parameter
testId TestDescription: Identifiziert den Test

testLog

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

Stellt die zugehörigen Log- oder Debug-Daten aus dem Testaufruf bereit.

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

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Protokoll bereit. und ggf. den Geräte-Logcat.

Parameter
dataName String: Ein beschreibender String-Name der Daten. z.B. „device_logcat“. Hinweis dataName darf pro Aufruf nicht eindeutig sein. d. h. Implementierungsteams müssen Mehrere Aufrufe mit demselben dataName

dataType LogDataType: die LogDataType der Daten

dataStream InputStreamSource: die InputStreamSource der Daten. Implementierungslösungen sollten createInputStream, um mit dem Lesen der Daten zu beginnen und sicherzustellen, dass das resultierende InputStream, wenn abgeschlossen ist. Anrufer sollten dafür sorgen, dass die Datenquelle nicht verloren geht. vorhanden und zugänglich sind, bis die testLog-Methode abgeschlossen ist.

TestModulBeendet

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn eines laufenden Moduls. Dieser Callback ist testModuleEnded() zugeordnet und in der Sequenz optional. Es wird nur während einer Ausführung verwendet, bei der Module: Suite-basierte Runner.

Parameter
moduleContext IInvocationContext: IInvocationContext des Moduls.

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Ende des Testlaufs für Berichte. PROBLEM: Es können nicht zwei Karten verwendet werden.<> mit unterschiedlichen Typen. Wir müssen hier HashMap verwenden.

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

runMetrics : Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden.

testRunFailed (Testlauf fehlgeschlagen)

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines von FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

Parameter
failure FailureDescription: FailureDescription, der den Fehler und seinen Kontext beschreibt.

testRunFailed (Testlauf fehlgeschlagen)

public void testRunFailed (String reason)

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

Parameter
reason String: String, die 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 der Testausführung

testCount int: Gesamtzahl der Tests im Testlauf

attemptNumber int: Bestellnummer, die die verschiedenen Versuche desselben runName-Elements identifiziert die mehrmals ausgeführt werden. Die "tryNumber" ist 0-indexiert und muss jedes Mal erhöht werden. eine neue Ausführung stattfindet. z.B. Ein Test ist detailliert 3-mal wiederholt und sollte insgesamt 4 Mal wiederholt werden. unter demselben runName-Wert ausgeführt, und der Wert liegt zwischen 0 und 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Start eines Testlaufs.

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)

Meldet den Start eines Testlaufs.

Parameter
runName String: der Name der Testausführung

testCount int: Gesamtzahl der Tests im Testlauf

attemptNumber int: Bestellnummer, die die verschiedenen Versuche desselben runName-Elements identifiziert die mehrmals ausgeführt werden. Die "tryNumber" ist 0-indexiert und sollte jedes Mal erhöht werden, wenn ein neue Ausführung stattfindet. z.B. Ein Test ist detailliert 3-mal wiederholt und sollte insgesamt 4 Durchläufe umfassen. „runName“ und die „tryNumber“ liegt zwischen 0 und 3.

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.

AUFGABE: Derzeit nicht verwendet, entfernen Sie eventuell

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 normalerweise nicht erwarteten Grund nicht ausgeführt wurde. Es wird versucht, diese Tests zu wiederholen, um eine ordnungsgemäße Ausführung zu erzielen.

Parameter
testId TestDescription: Identifiziert den Test

reason SkipReason: SkipReason

testgestartet

public void testStarted (TestDescription testId, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), wobei auch der Zeitpunkt des Tests angegeben wird gestartet, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung.

Parameter
testId TestDescription: Identifiziert den Test

startTime long: der Zeitpunkt, zu dem der Test gestartet wurde, gemessen über System.currentTimeMillis()

testgestartet

public void testStarted (TestDescription testId)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Benutzeroberfläche; sollte nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription) verwendet werden.

Parameter
testId TestDescription: Identifiziert den Test