ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.proto.ProtoResultReporter

Der Ergebnis-Reporter 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 einer Fehlerbedingung gemeldet.

void invocationFailed(Throwable cause)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

void invocationSkipped(SkipReason reason)

Meldet einen Aufruf als übersprungen

final 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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist.

void processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)

Verwenden Sie den Aufrufdatensatz, um nacheinander alle endgültigen Logs des Aufrufs 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 invocationStarted(com.android.tradefed.invoker.IInvocationContext)

void processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)

Umgang mit dem finalisierten Testfall-Prototyp nach ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

void processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)

Umgang mit dem Prototyp des Testfalleintrags nach testStarted(com.android.tradefed.result.TestDescription, long)

void processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)

Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach testModuleEnded()

void processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)

Umgang mit dem Prototyp des teilweisen Moduleintrags nach testModuleStarted(com.android.tradefed.invoker.IInvocationContext)

void processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Umgang mit dem finalisierten Ausführungsprotokoll-Proto nach ERROR(/#testRunEnded(long,HashMap))

void processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)

Umgang mit dem Prototyp des Datensatzes für den teilweisen Testlauf nach testRunStarted(String, int)

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, testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können.

void testEnded(TestDescription test, testMetrics)

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)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

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 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, runMetrics)

Ende des Testlaufs für Berichte.

final void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, nicht abgeschlossen werden.

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)

Meldet den Start eines Testlaufs.

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 normalerweise nicht erwarteten Grund nicht ausgeführt wurde.

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.

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)

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

invocationFailed

public void invocationFailed (Throwable cause)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
cause Throwable: die Throwable Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Eine Aufrufe wird als übersprungen gemeldet

Parameter
reason SkipReason

invocationStarted

public final 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 LogFile, die zuvor protokolliert wurde und 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 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 fertige 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 teilweise Proto, das nach „invocationStart“ 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 Prototyp des teilweisen Testfalleintrags nach testStarted(com.android.tradefed.result.TestDescription, long)

Parameter
testCaseStartedRecord TestRecordProto.TestRecord: Der Teil des Prototyps, der den Testfall darstellt.

ProzessTestModulEnde

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach testModuleEnded()

Parameter
moduleRecord TestRecordProto.TestRecord: Der abgeschlossene Proto, der das Modul darstellt.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Umgang mit dem Prototyp des teilweisen Moduleintrags 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: gibt an, ob ein Modul gerade ausgeführt wird oder nicht.

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 Atomtest meldet, dass eine Bedingung 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 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)), 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 Zeit, 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

TestFehlgeschlagen

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.

TestFehlgeschlagen

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

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 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: Suite-basierte Auslöser.

Parameter
moduleContext IInvocationContext: IInvocationContext des Moduls.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Ende des Testlaufs für Berichte.

Parameter
elapsedTimeMillis long: Vom Gerät gemeldete verstrichene Zeit in Millisekunden
runMetrics : Schlüssel/Wert-Paare, die am Ende eines Testlaufs gemeldet werden

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 (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 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: Bestellnummer, die die verschiedenen Versuche desselben runName-Elements identifiziert, die mehrmals ausgeführt werden Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe mit demselben „runName“ haben 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 er insgesamt vier Durchläufe unter demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen.
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 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: 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. 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