ProtoResultReporter
public
abstract
class
ProtoResultReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Der Ergebnisberichter erstellt ein TestRecord-Protobuf mit allen Ergebnissen. Sollte erweitert werden, um zu steuern, was mit dem endgültigen Prototyp in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) geschehen soll.
Zusammenfassung
Öffentliche Konstruktoren | |
|---|---|
ProtoResultReporter()
|
|
Öffentliche Methoden | |
|---|---|
final
void
|
invocationEnded(long elapsedTime)
Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden. |
void
|
invocationFailed(FailureDescription failure)
Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet. |
void
|
invocationFailed(Throwable cause)
Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet. |
void
|
invocationSkipped(SkipReason reason)
Eine Aufrufung wird als übersprungen gemeldet. |
void
|
invocationStarted(IInvocationContext context)
Gibt den Beginn der Testausführung an. |
final
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 |
void
|
processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)
Verwenden Sie den Aufrufeintrag, um alle endgültigen Protokolle der Aufrufe einzeln zu senden. |
void
|
processFinalProto(TestRecordProto.TestRecord finalRecord)
Umgang mit dem endgültigen Prototyp mit allen Ergebnissen |
void
|
processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Umgang mit dem Testprotokoll für die teilweise Aufrufung nach |
void
|
processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)
Umgang mit dem finalisierten Testfall-Prototyp nach |
void
|
processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)
Umgang mit dem teilweisen Testfall-Prototyp nach |
void
|
processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)
Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach |
void
|
processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)
Umgang mit dem Prototyp des teilweisen Moduleintrags nach |
void
|
processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Umgang mit dem finalisierten Ausführungsprotokoll-Proto nach |
void
|
processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)
Umgang mit dem Prototyp des Datensatzes für den teilweisen Testlauf nach |
void
|
setGranularResults(boolean granularResults)
|
void
|
setInlineRecordOfChildren(boolean inline)
|
boolean
|
supportGranularResults()
Gibt „True“ zurück, wenn der Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist. |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist. |
final
void
|
testEnded(TestDescription test, long endTime,
Alternative zu |
void
|
testEnded(TestDescription test,
Gibt das Ende der Ausführung eines einzelnen Testfalls an. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
final
void
|
testFailed(TestDescription test, String trace)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
final
void
|
testIgnored(TestDescription test)
Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel weil eine Testmethode mit org.junit.Ignore annotiert ist. |
final
void
|
testModuleEnded()
Gibt das Ende eines Modullaufs an. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Gibt den Beginn der Ausführung eines Moduls an. |
final
void
|
testRunEnded(long elapsedTimeMillis,
Gibt das Ende des Testlaufs an. |
final
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der 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)
Gibt den Beginn eines Testlaufs an. |
final
void
|
testRunStarted(String runName, int testCount)
Gibt den Beginn eines Testlaufs an. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Gibt den Beginn eines Testlaufs an. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. |
final
void
|
testStarted(TestDescription test, long startTime)
Alternative zu |
final
void
|
testStarted(TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. |
Geschützte Methoden | |
|---|---|
void
|
afterModuleEnd()
|
void
|
beforeModuleStart()
|
TestRecordProto.ChildReference
|
createModuleChildReference(TestRecordProto.TestRecord record)
Erstellt eine untergeordnete Referenz für ein Modul. |
Öffentliche Konstruktoren
ProtoResultReporter
public ProtoResultReporter ()
Öffentliche Methoden
invocationEnded
public final 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 eines Fehlers 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 eines Fehlers gemeldet.
Wird automatisch vom TradeFederation-Framework aufgerufen.
| Parameter | |
|---|---|
cause |
Throwable: die Throwable Ursache des Fehlers |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Eine Aufrufung wird als übersprungen gemeldet.
| Parameter | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
Gibt den Beginn der Testausführung an.
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 zur Aufrufung |
logAssociation
public final 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 zuvor protokollierte LogFile, die mit dem Testfall verknüpft werden soll. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Verwenden Sie den Aufrufeintrag, um alle endgültigen Protokolle der Aufrufe einzeln zu senden.
| Parameter | |
|---|---|
invocationLogs |
TestRecordProto.TestRecord: Das fertige Proto, das die Aufrufe darstellt. |
processFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Umgang mit dem endgültigen Prototyp mit allen Ergebnissen
| Parameter | |
|---|---|
finalRecord |
TestRecordProto.TestRecord: Das fertige Proto mit allen Aufrufergebnissen. |
processStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord,
IInvocationContext invocationContext)Umgang mit dem Testprotokoll für die teilweise Aufrufung nach invocationStarted(com.android.tradefed.invoker.IInvocationContext)
| Parameter | |
|---|---|
invocationStartRecord |
TestRecordProto.TestRecord: Das teilweise Proto, das nach dem Aufrufstart ausgefüllt wird. |
invocationContext |
IInvocationContext: Der Aufruf IInvocationContext. |
processTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Umgang mit dem finalisierten Testfall-Prototyp nach ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
| Parameter | |
|---|---|
testCaseRecord |
TestRecordProto.TestRecord: Das fertige Proto, das einen Testfall darstellt. |
processTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Umgang mit dem teilweisen Testfall-Prototyp nach testStarted(com.android.tradefed.result.TestDescription, long)
| Parameter | |
|---|---|
testCaseStartedRecord |
TestRecordProto.TestRecord: Der Teil des Prototyps, der den Testfall darstellt. |
processTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach testModuleEnded()
| Parameter | |
|---|---|
moduleRecord |
TestRecordProto.TestRecord: Das fertige Proto, das das Modul darstellt. |
processTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Umgang mit dem Prototyp des teilweisen Modul-Eintrags nach testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
| Parameter | |
|---|---|
moduleStartRecord |
TestRecordProto.TestRecord: Das teilweise Proto, das das Modul darstellt. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord,
boolean moduleInProgress)Umgang mit dem finalisierten Ausführungsprotokoll-Proto nach ERROR(/#testRunEnded(long,HashMap))
| Parameter | |
|---|---|
runRecord |
TestRecordProto.TestRecord: Das fertige Proto, das den Lauf darstellt. |
moduleInProgress |
boolean: ob ein Modul gerade bearbeitet wird. |
processTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Umgang mit dem Prototyp des Datensatzes für den teilweisen Testlauf nach testRunStarted(String, int)
| Parameter | |
|---|---|
runStartedRecord |
TestRecordProto.TestRecord: Das teilweise Proto, das den Lauf 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 Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“.
| Returns | |
|---|---|
boolean |
|
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
trace |
String: Stack-Trace des Fehlers |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
failure |
FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt. |
testEnded
public final void testEnded (TestDescription test, long endTime,testMetrics)
Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. Kombinieren Sie diesen Messwert mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
endTime |
long: Die Uhrzeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis() |
testMetrics |
ERROR(/Map) der gesendeten Messwerte |
testEnded
public void testEnded (TestDescription test,testMetrics)
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 | |
|---|---|
test |
TestDescription: identifiziert den Test |
testMetrics |
ERROR(/Map) der gesendeten Messwerte |
testFailed
public final void testFailed (TestDescription test, FailureDescription failure)
Hier wird der Fehler eines einzelnen Testfalls gemeldet.
Wird zwischen „testStarted“ und „testEnded“ aufgerufen.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
failure |
FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt. |
testFailed
public final void testFailed (TestDescription test, String trace)
Hier wird der Fehler eines einzelnen Testfalls gemeldet.
Wird zwischen „testStarted“ und „testEnded“ aufgerufen.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
trace |
String: Stack-Trace des Fehlers |
testIgnored
public final void testIgnored (TestDescription test)
Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel weil eine Testmethode mit org.junit.Ignore annotiert ist.
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
testModuleEnded
public final void testModuleEnded ()
Gibt das Ende eines Modullaufs an.
testModuleStarted
public final 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 bei einem Lauf verwendet, bei dem Module verwendet werden: suitebasierte Auslöser.
| Parameter | |
|---|---|
moduleContext |
IInvocationContext: die IInvocationContext des Moduls. |
testRunEnded
public final void testRunEnded (long elapsedTimeMillis,
runMetrics) Gibt das Ende des Testlaufs an.
| Parameter | |
|---|---|
elapsedTimeMillis |
long: Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
runMetrics |
|
testRunFailed
public final 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 final void testRunFailed (String errorMessage)
Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
| Parameter | |
|---|---|
errorMessage |
String: String mit einer Beschreibung des Grunds für den Ausführungsfehler. |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)Gibt den Beginn eines Testlaufs an.
| 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 viermal unter demselben „runName“ ausgeführt werden und die „attemptNumber“ sollte von 0 auf 3 steigen. |
testRunStarted
public final void testRunStarted (String runName,
int testCount)Gibt den Beginn eines Testlaufs an.
| 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)Gibt den Beginn eines Testlaufs an.
| 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 es insgesamt vier Durchläufe mit demselben „runName“ geben und die „attemptNumber“ sollte zwischen 0 und 3 liegen. |
startTime |
long: Zeitpunkt des Beginns der Ausführung, gemessen über System.currentTimeMillis() |
testSkipped
public final void testSkipped (TestDescription test, 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 | |
|---|---|
test |
TestDescription: identifiziert den Test |
reason |
SkipReason: SkipReason |
testStarted
public final void testStarted (TestDescription test, 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 | |
|---|---|
test |
TestDescription: identifiziert den Test |
startTime |
long: Die Uhrzeit, zu der der Test gestartet wurde, gemessen über System.currentTimeMillis() |
testStarted
public final void testStarted (TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).
| Parameter | |
|---|---|
test |
TestDescription: identifiziert den Test |
Geschützte Methoden
afterModuleEnd
protected void afterModuleEnd ()
beforeModuleStart
protected void beforeModuleStart ()
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Erstellt eine untergeordnete Referenz für ein Modul.
| Parameter | |
|---|---|
record |
TestRecordProto.TestRecord |
| Returns | |
|---|---|
TestRecordProto.ChildReference |
|