ProtoResultReporter

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

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


Der Ergebnisreporter erstellt einen TestRecord Protobuf mit allen darin enthaltenen Ergebnissen. Sollte erweitert werden, um zu handhaben, was mit dem endgültigen Proto in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) geschehen soll.

Zusammenfassung

Öffentliche Bauträger

ProtoResultReporter ()

Öffentliche Methoden

final void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf erfolgreich oder aufgrund einer Fehlerbedingung beendet wurde.

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 einem Testfall verknüpft sein, es besteht jedoch die Möglichkeit, dies direkt über testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Rückruf ist nicht möglich.

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Verwenden Sie den Aufrufdatensatz, um nacheinander alle endgültigen Protokolle des Aufrufs zu senden.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

Abwicklung des finalen Prototyps mit allen Ergebnissen.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Behandlung des Teilaufruf-Testdatensatzprotos nach dem Auftreten invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Behandlung des endgültigen Testfalldatensatz-Protos, nachdem ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) aufgetreten ist.

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Behandlung des teilweisen Testfalldatensatz-Protos, nachdem testStarted(com.android.tradefed.result.TestDescription, long) aufgetreten ist.

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Behandlung des finalisierten Moduldatensatz-Protos nach dem Auftreten von testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Behandlung des partiellen Moduldatensatz-Protos nach dem Auftreten testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Behandlung des endgültigen Laufdatensatzprotokolls, nachdem ERROR(/#testRunEnded(long,HashMap)) aufgetreten ist.

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Behandlung des teilweisen Testlauf-Datensatzprotos nach dem Auftreten testRunStarted(String, int) .

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 er eine falsche Bedingung annimmt

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

final void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Meldet das Ausführungsende eines einzelnen Testfalls.

final void testFailed ( TestDescription test, FailureDescription failure)

Meldet den Fehler eines einzelnen Testfalls.

final void testFailed ( TestDescription test, String trace)

Meldet den Fehler eines einzelnen Testfalls.

final void testIgnored ( TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore annotiert ist.

final void testModuleEnded ()

Meldet das Ende eines Modullaufs.

final void testModuleStarted ( IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

Meldet das Ende des Testlaufs.

final void testRunFailed ( FailureDescription failure)

Der Testlauf des Berichts konnte aufgrund eines in FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

final void testRunFailed (String errorMessage)

Der Testlauf des Berichts 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 testStarted(com.android.tradefed.result.TestDescription) , wo wir auch angeben, wann der Test gestartet wurde, kombiniert mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung .

final void testStarted ( TestDescription test)

Meldet den Beginn eines einzelnen Testfalls.

Geschützte Methoden

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Erstellt eine untergeordnete Referenz für ein Modul.

Öffentliche Bauträger

ProtoResultReporter

public ProtoResultReporter ()

Öffentliche Methoden

invocationEnded

public final void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf erfolgreich oder aufgrund einer Fehlerbedingung beendet wurde.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long : die verstrichene Zeit des Aufrufs in ms

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

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung über mehrere Geräte zu unterstützen.

Parameter
context IInvocationContext : Informationen zum Aufruf

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit einem Testfall verknüpft sein, es besteht jedoch die Möglichkeit, dies direkt über testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Rückruf ist nicht möglich. Somit ermöglicht dieser Rückruf die explizite Bereitstellung einer starken Assoziation.

Parameter
dataName String : Der Name der Daten

logFile LogFile : die LogFile , die zuvor protokolliert wurde und dem Testfall zugeordnet werden sollte.

ProcessFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Verwenden Sie den Aufrufdatensatz, um nacheinander alle endgültigen Protokolle des Aufrufs zu senden.

Parameter
invocationLogs TestRecordProto.TestRecord : Das finalisierte Proto, das den Aufruf darstellt.

ProzessFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Abwicklung des finalen Prototyps mit allen Ergebnissen.

Parameter
finalRecord TestRecordProto.TestRecord : Das finalisierte Proto mit allen Aufrufergebnissen.

ProcessStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Behandlung des Teilaufruf-Testdatensatzprotos nach dem Auftreten invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Parameter
invocationStartRecord TestRecordProto.TestRecord : Das Teilproto, das nach dem invocationStart aufgefüllt wird.

invocationContext IInvocationContext : Der Aufruf- IInvocationContext .

ProcessTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Behandlung des endgültigen Testfalldatensatz-Protos, nachdem ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) aufgetreten ist.

Parameter
testCaseRecord TestRecordProto.TestRecord : Das finalisierte Proto, das einen Testfall darstellt.

ProzessTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Behandlung des teilweisen Testfalldatensatz-Protos, nachdem testStarted(com.android.tradefed.result.TestDescription, long) aufgetreten ist.

Parameter
testCaseStartedRecord TestRecordProto.TestRecord : Das Teilproto, das den Testfall darstellt.

ProcessTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Behandlung des finalisierten Moduldatensatz-Protos nach dem Auftreten von testModuleEnded() .

Parameter
moduleRecord TestRecordProto.TestRecord : Das finalisierte Proto, das das Modul darstellt.

ProcessTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Behandlung des partiellen Moduldatensatz-Protos nach dem Auftreten testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Parameter
moduleStartRecord TestRecordProto.TestRecord : Das Teilproto, das das Modul darstellt.

ProcessTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Behandlung des endgültigen Laufdatensatzprotokolls, nachdem ERROR(/#testRunEnded(long,HashMap)) aufgetreten ist.

Parameter
runRecord TestRecordProto.TestRecord : Das finalisierte Proto, das den Lauf darstellt.

moduleInProgress boolean : ob ein Modul in Bearbeitung ist oder nicht.

ProcessTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Behandlung des teilweisen Testlauf-Datensatzprotos nach dem Auftreten testRunStarted(String, int) .

Parameter
runStartedRecord TestRecordProto.TestRecord : Das Teilproto, 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 Reporter detaillierte Ergebnisse unterstützt, andernfalls „False“.

Kehrt zurück
boolean

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

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 er eine falsche Bedingung annimmt

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)) wo wir die Endzeit direkt angeben können. Für eine genaue Messung mit testStarted(com.android.tradefed.result.TestDescription, long) kombinieren.

Parameter
test TestDescription : Identifiziert den Test

endTime long : Die Zeit, zu der der Test endete, gemessen über System.currentTimeMillis()

testMetrics : ein ERROR(/Map) der ausgegebenen Metriken

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Meldet das Ausführungsende eines einzelnen Testfalls.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt außerdem alle Schlüssel-/Wertmetriken zurück, die möglicherweise während der Ausführung des Testfalls ausgegeben wurden.

Parameter
test TestDescription : Identifiziert den Test

testMetrics : ein ERROR(/Map) der ausgegebenen Metriken

im Test durchgefallen

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet den Fehler eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
test TestDescription : Identifiziert den Test

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

im Test durchgefallen

public final void testFailed (TestDescription test, 
                String trace)

Meldet den Fehler eines einzelnen Testfalls.

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, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore annotiert ist.

Parameter
test TestDescription : Identifiziert den Test

testModuleEnded

public final void testModuleEnded ()

Meldet das Ende eines Modullaufs.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls. Dieser Rückruf ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur während eines Laufs verwendet, der Module verwendet: Suite-basierte Läufer.

Parameter
moduleContext IInvocationContext : der IInvocationContext des Moduls.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichem Typ haben, daher müssen wir hier HashMap verwenden.

Parameter
elapsedTimeMillis long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

Der Testlauf des Berichts konnte aufgrund eines in FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

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

testRunFailed

public final void testRunFailed (String errorMessage)

Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage String : String , der 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 des Testlaufs

testCount int : Gesamtzahl der Tests im Testlauf

attemptNumber int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jedem neuen Lauf erhöht werden. Beispielsweise wird ein Test granular dreimal wiederholt, es sollten insgesamt 4 Ausführungen unter demselben runName erfolgen und die Versuchsnummer liegt zwischen 0 und 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Meldet den Start eines Testlaufs.

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)

Meldet den Start eines Testlaufs.

Parameter
runName String : der Name des Testlaufs

testCount int : Gesamtzahl der Tests im Testlauf

attemptNumber int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jedem neuen Lauf erhöht werden. Beispielsweise wird ein Test granular dreimal wiederholt, es sollten insgesamt 4 Ausführungen unter demselben runName erfolgen und die Versuchsnummer liegt zwischen 0 und 3.

startTime long : Die Zeit, zu der der Lauf gestartet wurde, gemessen über System.currentTimeMillis()

testÜbersprungen

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

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) , wo wir auch angeben, wann der Test gestartet wurde, kombiniert mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung .

Parameter
test TestDescription : Identifiziert den Test

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

testgestartet

public final void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testfalls. Bei älteren Schnittstellen 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

Kehrt zurück
TestRecordProto.ChildReference