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 |
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,
Alternative zu |
void
|
testEnded(TestDescription testId,
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,
Ende des Testlaufs für Berichte. |
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines von |
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 |
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 |