ProtoResultReporter
public
abstract
class
ProtoResultReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
😎 | com.android.tradefed.result.proto.ProtoResultReporter |
Der Ergebnisreporter erstellt einen TestRecord
-Protokollzwischenspeicher mit allen Ergebnissen. Sollte sein
erweitert, um zu verarbeiten, was mit der endgültigen Proto-Datei in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
geschehen soll.
Zusammenfassung
Öffentliche Konstruktoren | |
---|---|
ProtoResultReporter()
|
Öffentliche Methoden | |
---|---|
final
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
|
invocationSkipped(SkipReason reason)
Meldet einen Aufruf als übersprungen |
final
void
|
invocationStarted(IInvocationContext context)
Meldet den Beginn des Testaufrufs. |
final
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
|
processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)
Verwenden Sie den Aufrufdatensatz, um nacheinander alle endgültigen Logs des Aufrufs zu senden. |
void
|
processFinalProto(TestRecordProto.TestRecord finalRecord)
Verarbeitung des endgültigen Proto mit allen Ergebnissen. |
void
|
processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Verarbeitung des Testeintrags-Protokolls für Teilaufrufe nach dem Auftreten von |
void
|
processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)
Verarbeitung des fertigen Protokolls des Testlauf-Eintrags nach |
void
|
processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)
Verarbeitung des unvollständigen Protokolls des Testfalleintrags nach dem Auftreten von |
void
|
processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)
Verarbeitung des abgeschlossenen Protokolls des Moduleintrags nach |
void
|
processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)
Verarbeitung des Protokolls des Teildatensatzes des Moduls nach dem Auftreten von |
void
|
processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Verarbeitung des abgeschlossenen Protokolls für den Ausführungseintrag nach |
void
|
processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)
Behandlung des Protokolls für den Teiltestlaufsatz nach |
void
|
setGranularResults(boolean granularResults)
|
void
|
setInlineRecordOfChildren(boolean inline)
|
boolean
|
supportGranularResults()
Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „false“. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist |
final
void
|
testEnded(TestDescription test, long endTime,
Alternative zu |
void
|
testEnded(TestDescription test,
Meldet das Ausführungsende eines einzelnen Testlaufs. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Meldet das Scheitern eines einzelnen Testlaufs. |
final
void
|
testFailed(TestDescription test, String trace)
Meldet das Scheitern eines einzelnen Testlaufs. |
final
void
|
testIgnored(TestDescription test)
Wird aufgerufen, wenn ein Test nicht ausgeführt wird. Dies ist im Allgemeinen der Fall, weil eine Testmethode mit org.junit.Ignorieren. |
final
void
|
testModuleEnded()
Meldet das Ende einer Modulausführung. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Meldet den Beginn eines laufenden Moduls. |
final
void
|
testRunEnded(long elapsedTimeMillis,
Ende des Testlaufs für Berichte. |
final
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines von |
final
void
|
testRunFailed(String errorMessage)
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. |
final
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. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen und aus einem normalerweise nicht erwarteten Grund nicht ausgeführt wurde. |
final
void
|
testStarted(TestDescription test, long startTime)
Alternative zu |
final
void
|
testStarted(TestDescription test)
Meldet den Beginn eines einzelnen Testlaufs. |
Geschützte Methoden | |
---|---|
TestRecordProto.ChildReference
|
createModuleChildReference(TestRecordProto.TestRecord record)
Erstellt eine untergeordnete Referenz für ein Modul. |
Öffentliche Konstruktoren
ProtoResultReporter
public ProtoResultReporter ()
Öffentliche Methoden
Aufrufende beendet
public final 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 |
callSkipped
public void invocationSkipped (SkipReason reason)
Meldet einen Aufruf als übersprungen
Parameter | |
---|---|
reason |
SkipReason |
callStarted
public final 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 final 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. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Verwenden Sie den Aufrufdatensatz, um nacheinander alle endgültigen Logs des Aufrufs zu senden.
Parameter | |
---|---|
invocationLogs |
TestRecordProto.TestRecord : Das abgeschlossene Proto, das den Aufruf darstellt. |
ProcessFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Verarbeitung des endgültigen Proto mit allen Ergebnissen.
Parameter | |
---|---|
finalRecord |
TestRecordProto.TestRecord : Das abgeschlossene Proto mit allen Aufrufergebnissen. |
ProcessStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Verarbeitung des Testeintrags-Protokolls für Teilaufrufe nach dem Auftreten von invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parameter | |
---|---|
invocationStartRecord |
TestRecordProto.TestRecord : Das partielle Proto, das nach „callStart“ ausgefüllt wird. |
invocationContext |
IInvocationContext : Der Aufruf IInvocationContext . |
ProcessTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Verarbeitung des fertigen Protokolls des Testlauf-Eintrags nach ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
.
Parameter | |
---|---|
testCaseRecord |
TestRecordProto.TestRecord : Der abgeschlossene Proto, der einen Testlauf darstellt. |
ProcessTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Verarbeitung des unvollständigen Protokolls des Testfalleintrags nach dem Auftreten von testStarted(com.android.tradefed.result.TestDescription, long)
.
Parameter | |
---|---|
testCaseStartedRecord |
TestRecordProto.TestRecord : Der partielle Proto, der den Testfall darstellt. |
ProzessTestModulEnde
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Verarbeitung des abgeschlossenen Protokolls des Moduleintrags nach testModuleEnded()
.
Parameter | |
---|---|
moduleRecord |
TestRecordProto.TestRecord : Der abgeschlossene Proto, der das Modul darstellt. |
ProcessTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Verarbeitung des Protokolls des Teildatensatzes des Moduls nach dem Auftreten von testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parameter | |
---|---|
moduleStartRecord |
TestRecordProto.TestRecord : Der partielle Proto, der das Modul darstellt. |
ProcessTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Verarbeitung des abgeschlossenen Protokolls für den Ausführungseintrag nach ERROR(/#testRunEnded(long,HashMap))
aufgetreten.
Parameter | |
---|---|
runRecord |
TestRecordProto.TestRecord : Der abgeschlossene Proto, der die Ausführung darstellt. |
moduleInProgress |
boolean : gibt an, ob ein Modul gerade ausgeführt wird oder nicht. |
ProcessTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Behandlung des Protokolls für den Teiltestlaufsatz nach testRunStarted(String, int)
aufgetreten.
Parameter | |
---|---|
runStartedRecord |
TestRecordProto.TestRecord : Der partielle Proto, der die Ausführung darstellt. |
setGranularResults
public void setGranularResults (boolean granularResults)
Parameter | |
---|---|
granularResults |
boolean |
SetInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
Parameter | |
---|---|
inline |
boolean |
supportGranularResults
public boolean supportGranularResults ()
Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „false“.
Returns | |
---|---|
boolean |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
trace |
String : Stacktrace des Fehlers |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
failure |
FailureDescription : FailureDescription , der den Fehler und seinen Kontext beschreibt. |
TestBeendet
public final void testEnded (TestDescription test, long endTime,testMetrics)
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 | |
---|---|
test |
TestDescription : Identifiziert den Test |
endTime |
long : die Zeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis() |
testMetrics |
: ein ERROR(/Map) der ausgegebenen Messwerte |
TestBeendet
public void testEnded (TestDescription test,testMetrics)
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 | |
---|---|
test |
TestDescription : Identifiziert den Test |
testMetrics |
: ein ERROR(/Map) der ausgegebenen Messwerte |
TestFehlgeschlagen
public final void testFailed (TestDescription test, FailureDescription failure)
Meldet das Scheitern eines einzelnen Testlaufs.
Wird zwischen testStarted und testEnded aufgerufen.
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
failure |
FailureDescription : FailureDescription , der den Fehler und seinen Kontext beschreibt. |
TestFehlgeschlagen
public final void testFailed (TestDescription test, String trace)
Meldet das Scheitern eines einzelnen Testlaufs.
Wird zwischen testStarted und testEnded aufgerufen.
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
trace |
String : Stacktrace des Fehlers |
testIgnoriert
public final void testIgnored (TestDescription test)
Wird aufgerufen, wenn ein Test nicht ausgeführt wird. Dies ist im Allgemeinen der Fall, weil eine Testmethode mit org.junit.Ignorieren.
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
TestModulBeendet
public final void testModuleEnded ()
Meldet das Ende einer Modulausführung.
testModuleStarted
public final 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 final void testRunEnded (long elapsedTimeMillis,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 | |
---|---|
elapsedTimeMillis |
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 final 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 final void testRunFailed (String errorMessage)
Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
Parameter | |
---|---|
errorMessage |
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 final 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() |
TestSkipped
public final void testSkipped (TestDescription test, 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 | |
---|---|
test |
TestDescription : Identifiziert den Test |
reason |
SkipReason : SkipReason |
testgestartet
public final void testStarted (TestDescription test, 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 | |
---|---|
test |
TestDescription : Identifiziert den Test |
startTime |
long : der Zeitpunkt, zu dem der Test gestartet wurde, gemessen über System.currentTimeMillis() |
testgestartet
public final void testStarted (TestDescription test)
Meldet den Beginn eines einzelnen Testlaufs. Ältere Benutzeroberfläche; sollte nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription)
verwendet werden.
Parameter | |
---|---|
test |
TestDescription : Identifiziert den Test |
Geschützte Methoden
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Erstellt eine untergeordnete Referenz für ein Modul.
Parameter | |
---|---|
record |
TestRecordProto.TestRecord |
Returns | |
---|---|
TestRecordProto.ChildReference |