ResultReporter
public
class
ResultReporter
extends Object
implements
IConfigurationReceiver,
ILogSaverListener,
ISupportGranularResults,
ITestSummaryListener
| java.lang.Object | |
| ↳ | com.google.android.tradefed.result.teststorage.ResultReporter |
Zusammenfassung
Verschachtelte Klassen | |
|---|---|
class |
ResultReporter.ListBuilder<T>
|
Konstanten | |
|---|---|
String |
DEFAULT_BUILDPROVIDER
|
String |
EXPERIMENTAL
|
String |
SYSTEM_CHECKER
|
String |
TRADEFED
|
Öffentliche Konstruktoren | |
|---|---|
ResultReporter()
|
|
Öffentliche Methoden | |
|---|---|
void
|
enableFilterProperty(boolean enableFilterProperty)
|
IConfiguration
|
getConfiguration()
|
TestSummary
|
getSummary()
Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben. |
void
|
invocationEnded(long elapsedTime)
Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands. |
void
|
invocationFailed(FailureDescription failure)
Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands. |
void
|
invocationFailed(Throwable cause)
Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands. |
void
|
invocationSkipped(SkipReason reason)
Meldet einen Aufruf als übersprungen |
void
|
invocationStarted(IInvocationContext context)
Meldet den Beginn des Testaufrufs. |
void
|
logAssociation(String dataName, LogFile log)
In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten |
void
|
putEarlySummary(List<TestSummary> summaries)
Übergibt ein |
void
|
reportLogToResultDB(List<LogAssociation> logAssociations, ResultDBReporter rdbReporter)
|
void
|
setConfiguration(IConfiguration configuration)
Fügt die verwendete |
void
|
setLogSaver(ILogSaver logSaver)
Legen Sie |
boolean
|
supportGranularResults()
Gibt „True“ zurück, wenn der Bericht detaillierte Ergebnisse unterstützt, andernfalls „False“. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist. |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist. |
void
|
testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Alternative zu |
void
|
testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> metrics)
Meldet das Ende der Ausführung eines einzelnen Testlaufs. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Meldet das Fehlschlagen eines einzelnen Testlaufs. |
void
|
testFailed(TestDescription test, String trace)
Meldet das Fehlschlagen eines einzelnen Testlaufs. |
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
|
testModuleEnded()
Meldet das Ende einer Modulausführung. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Meldet den Beginn der Ausführung eines Moduls. |
void
|
testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)
Meldet das Ende des Testlaufs. |
void
|
testRunFailed(FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch |
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 Beginn eines Testlaufs. |
void
|
testRunStarted(String runName, int testCount)
Meldet den Beginn eines Testlaufs. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Meldet den Beginn eines Testlaufs. |
void
|
testSkipped(TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen wurde 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)
Meldet den Beginn eines einzelnen Testlaufs. |
Geschützte Methoden | |
|---|---|
ITestStorageClient
|
createTestStorageClient(IInvocationContext context)
|
String
|
getVersion()
|
Konstanten
DEFAULT_BUILDPROVIDER
public static final String DEFAULT_BUILDPROVIDER
Konstanter Wert: "androidbuild"
EXPERIMENTELL
public static final String EXPERIMENTAL
Konstanter Wert: "experimental"
SYSTEM_CHECKER
public static final String SYSTEM_CHECKER
Konstanter Wert: "system_checker"
TRADEFED
public static final String TRADEFED
Konstanter Wert: "tradefed"
Öffentliche Konstruktoren
ResultReporter
public ResultReporter ()
Öffentliche Methoden
enableFilterProperty
public void enableFilterProperty (boolean enableFilterProperty)
| Parameter | |
|---|---|
enableFilterProperty |
boolean |
getSummary
public TestSummary getSummary ()
Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.
| Gibt Folgendes zurück: | |
|---|---|
TestSummary |
Eine TestSummary, die den Lauf zusammenfasst, oder „null“ |
invocationEnded
public void invocationEnded (long elapsedTime)
Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
Wird automatisch vom TradeFederation-Framework aufgerufen.
| Parameter | |
|---|---|
elapsedTime |
long: die verstrichene Zeit des Aufrufs in Millisekunden |
invocationFailed
public void invocationFailed (FailureDescription failure)
Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
Wird automatisch vom TradeFederation-Framework aufgerufen.
| Parameter | |
|---|---|
failure |
FailureDescription: die FailureDescription, in der die Ursache des Fehlers beschrieben wird |
invocationFailed
public void invocationFailed (Throwable cause)
Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
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 void invocationStarted (IInvocationContext context)
Meldet den Beginn des Testaufrufs.
Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung für mehrere Geräte zu unterstützen.
| Parameter | |
|---|---|
context |
IInvocationContext: Informationen zum Aufruf |
logAssociation
public void logAssociation (String dataName,
LogFile log)In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String,LogDataType,InputStreamSource,LogFile)-Callback nicht. Mit diesem Callback kann also explizit eine starke Zuordnung angegeben werden.
| Parameter | |
|---|---|
dataName |
String: Der Name der Daten |
log |
LogFile: Die LogFile, die zuvor protokolliert wurde und dem Testlauf zugeordnet werden soll. |
putEarlySummary
public void putEarlySummary (List<TestSummary> summaries)
Übergibt ein List von TestSummarys, die nicht null sind und möglicherweise von ITestInvocationListeners zurückgegeben wurden, die als Teil der Konfiguration instanziiert wurden. Die ersten Zusammenfassungen werden nach invocationStarted(IInvocationContext) generiert und können am Ende des Aufrufs über putSummary(List) abgeschlossen werden.
Diese Funktion wird vor invocationStarted(IInvocationContext) aufgerufen und enthält alle Zusammenfassungen der Listener, die davor konfiguriert wurden.
| Parameter | |
|---|---|
summaries |
List: Ein List von TestSummarys, die nicht null sind, aus ITestInvocationListeners, die Teil der aktuellen Konfiguration sind. |
reportLogToResultDB
public void reportLogToResultDB (List<LogAssociation> logAssociations, ResultDBReporter rdbReporter)
| Parameter | |
|---|---|
logAssociations |
List |
rdbReporter |
ResultDBReporter |
| Löst aus | |
|---|---|
IOException |
|
setConfiguration
public void setConfiguration (IConfiguration configuration)
Fügt die verwendete IConfiguration ein.
| Parameter | |
|---|---|
configuration |
IConfiguration |
setLogSaver
public void setLogSaver (ILogSaver logSaver)
Legen Sie ILogSaver fest, damit der Implementierer Dateien speichern kann.
| Parameter | |
|---|---|
logSaver |
ILogSaver: Der ILogSaver |
supportGranularResults
public boolean supportGranularResults ()
Gibt „True“ zurück, wenn der Bericht detaillierte Ergebnisse unterstützt, andernfalls „False“.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
trace |
String: Stacktrace des Fehlers |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
failure |
FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden. |
testEnded
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Alternative zu testEnded(TestDescription,Map), mit der wir die Endzeit direkt angeben können. Kombinieren Sie sie mit testStarted(TestDescription,long), um genaue Ergebnisse zu erhalten.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
endTime |
long: Die Uhrzeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis() |
testMetrics |
HashMap: Map der ausgegebenen Messwerte |
testEnded
public void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> metrics)
Meldet das Ende der Ausführung eines einzelnen Testlaufs.
Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
metrics |
HashMap: Map der ausgegebenen Messwerte |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Meldet das Fehlschlagen eines einzelnen Testlaufs.
Wird zwischen „testStarted“ und „testEnded“ aufgerufen.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
failure |
FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden. |
testFailed
public void testFailed (TestDescription test, String trace)
Meldet das Fehlschlagen eines einzelnen Testlaufs.
Wird zwischen „testStarted“ und „testEnded“ aufgerufen.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
trace |
String: Stacktrace 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: Gibt den Test an. |
testModuleEnded
public void testModuleEnded ()
Meldet das Ende einer Modulausführung.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Meldet den Beginn der Ausführung eines Moduls. Dieser Callback ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Runner.
| Parameter | |
|---|---|
moduleContext |
IInvocationContext: Die IInvocationContext des Moduls. |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
HashMap<String, MetricMeasurement.Metric> runMetrics)Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichen Typen haben, daher müssen wir hier HashMap verwenden.
| Parameter | |
|---|---|
elapsedTimeMillis |
long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden. |
runMetrics |
HashMap: Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden. |
testRunFailed
public void testRunFailed (FailureDescription failure)
Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, nicht abgeschlossen werden.
| Parameter | |
|---|---|
failure |
FailureDescription: FailureDescription, in dem der Fehler und sein Kontext beschrieben werden. |
testRunFailed
public void testRunFailed (String errorMessage)
Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
| Parameter | |
|---|---|
errorMessage |
String: String, in dem der Grund für den Fehler bei der Ausführung beschrieben wird. |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)Meldet den Beginn eines Testlaufs.
| Parameter | |
|---|---|
runName |
String: der Name des Testlaufs |
testCount |
int: Gesamtzahl der Tests im Testlauf |
attemptNumber |
int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen. |
testRunStarted
public void testRunStarted (String runName,
int testCount)Meldet den Beginn 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 Beginn eines Testlaufs.
| Parameter | |
|---|---|
runName |
String: der Name des Testlaufs |
testCount |
int: Gesamtzahl der Tests im Testlauf |
attemptNumber |
int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Beispiel: Ein Test wird dreimal wiederholt. Er sollte insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen. |
startTime |
long: Der Zeitpunkt, zu dem der Lauf begonnen hat, gemessen mit System.currentTimeMillis() |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Wird aufgerufen, wenn ein Test übersprungen wurde und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. Diese Tests werden wiederholt, um eine ordnungsgemäße Ausführung zu erreichen.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
reason |
SkipReason: SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternative zu testStarted(TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit testEnded(TestDescription,long,Map) für eine genaue Messung.
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
startTime |
long: Die Uhrzeit, zu der der Test begonnen hat, gemessen über System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(TestDescription).
| Parameter | |
|---|---|
test |
TestDescription: Gibt den Test an. |
Geschützte Methoden
createTestStorageClient
protected ITestStorageClient createTestStorageClient (IInvocationContext context)
| Parameter | |
|---|---|
context |
IInvocationContext |
| Gibt Folgendes zurück: | |
|---|---|
ITestStorageClient |
|
| Löst aus | |
|---|---|
GeneralSecurityException |
|
IOException |
|
getVersion
protected String getVersion ()
| Gibt Folgendes zurück: | |
|---|---|
String |
|