ResultDBReporter
public
class
ResultDBReporter
extends Object
implements
IConfigurationReceiver,
ILogSaverListener,
ISupportGranularResults,
ITestSummaryListener
java.lang.Object | |
↳ | com.android.tradefed.result.resultdb.ResultDBReporter |
Ergebnisbericht, der Testergebnisse in ResultDB hochlädt.
Zusammenfassung
Öffentliche Konstruktoren | |
---|---|
ResultDBReporter()
|
Öffentliche Methoden | |
---|---|
TestSummary
|
getSummary()
Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben. |
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. |
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
|
setConfiguration(IConfiguration configuration)
Fügt den verwendeten |
void
|
setLogSaver(ILogSaver logSaver)
Legen Sie die |
boolean
|
supportGranularResults()
Gibt „True“ zurück, wenn der Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist. |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist. |
void
|
testEnded(TestDescription test, long endTime,
Alternative zu |
void
|
testEnded(TestDescription test,
Gibt das Ende der Ausführung eines einzelnen Testfalls an. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
void
|
testFailed(TestDescription test, String trace)
Hier wird der Fehler eines einzelnen Testfalls gemeldet. |
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. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung. |
void
|
testModuleEnded()
Gibt das Ende eines Modullaufs an. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Gibt den Beginn der Ausführung eines Moduls an. |
void
|
testRunEnded(long elapsedTimeMillis,
Gibt das Ende des Testlaufs an. |
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von |
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. |
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. |
void
|
testRunStopped(long elapsedTime)
Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet. |
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. |
void
|
testStarted(TestDescription test, long startTime)
Alternative zu |
void
|
testStarted(TestDescription test)
Gibt den Beginn eines einzelnen Testfalls an. |
Öffentliche Konstruktoren
ResultDBReporter
public ResultDBReporter ()
Öffentliche Methoden
getSummary
public TestSummary getSummary ()
Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.
Returns | |
---|---|
TestSummary |
Eine TestSummary , die den Lauf zusammenfasst, oder „null“ |
invocationEnded
public 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 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. |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Fügt den verwendeten IConfiguration
ein.
Parameter | |
---|---|
configuration |
IConfiguration |
setLogSaver
public void setLogSaver (ILogSaver logSaver)
Legen Sie die ILogSaver
fest, damit der Implementierer Dateien speichern kann.
Parameter | |
---|---|
logSaver |
ILogSaver : die ILogSaver |
supportGranularResults
public boolean supportGranularResults ()
Gibt „True“ zurück, wenn der Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“.
Returns | |
---|---|
boolean |
testAssumptionFailure
public 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 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 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 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 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 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 |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
Muss vor dem ERROR(/ITestInvocationListener#invocationFailed(Throwable))
oder ERROR(/ITestInvocationListener#invocationEnded(long))
aufgerufen werden
Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Hostprotokoll und gegebenenfalls das Geräte-Logcat bereit.
Parameter | |
---|---|
dataName |
String : Ein String aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis:
Der Datenname muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten. |
dataType |
LogDataType : die LogDataType der Daten |
dataStream |
InputStreamSource : die InputStreamSource der Daten. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen. Die Aufrufer müssen dafür sorgen, dass die Datenquelle bis zum Abschluss der testLog-Methode vorhanden und zugänglich ist. |
testModuleEnded
public void testModuleEnded ()
Gibt das Ende eines Modullaufs an.
testModuleStarted
public 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 void testRunEnded (long elapsedTimeMillis,runMetrics)
Gibt das Ende des Testlaufs an.
Parameter | |
---|---|
elapsedTimeMillis |
long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
runMetrics |
: Schlüssel/Wert-Paare, die am Ende eines Testlaufs erfasst werden |
testRunFailed
public 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 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 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() |
testRunStopped
public void testRunStopped (long elapsedTime)
Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.
TODO: currently unused, consider removing
Parameter | |
---|---|
elapsedTime |
long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
testSkipped
public 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 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 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 |