ShardListener
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
Ein ITestInvocationListener
, der Ergebnisse von einem Aufruf-Shard (auch bekannt als Aufrufaufteilung zur parallelen Ausführung auf mehreren Ressourcen) sammelt und sie an einen anderen Listener weiterleitet.
Zusammenfassung
Öffentliche Bauträger | |
---|---|
ShardListener ( ITestInvocationListener main) Erstellen Sie einen |
Öffentliche Methoden | |
---|---|
getUnderlyingResultReporter () | |
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 | invocationStarted ( IInvocationContext context) Meldet den Beginn des Testaufrufs. |
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 |
void | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „False“. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit. |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testModuleEnded () Meldet das Ende eines Modullaufs. |
void | testModuleStarted ( IInvocationContext moduleContext) Meldet den Beginn der Ausführung eines Moduls. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Meldet das Ende des Testlaufs. |
void | testRunFailed ( FailureDescription failure) Der Testlauf des Berichts konnte aufgrund eines in |
void | testRunFailed (String failureMessage) Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Meldet den Start eines Testlaufs. |
Öffentliche Bauträger
ShardListener
public ShardListener (ITestInvocationListener main)
Erstellen Sie einen ShardListener
.
Parameter | |
---|---|
main | ITestInvocationListener : Der ITestInvocationListener , dessen Ergebnisse weitergeleitet werden sollen. Um Kollisionen mit anderen ShardListener zu verhindern, wird dieses Objekt bei der Weiterleitung von Ergebnissen auf main synchronisiert. Und Ergebnisse werden erst gesendet, wenn der Aufruf-Shard abgeschlossen ist. |
Öffentliche Methoden
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
Kehrt zurück | |
---|---|
invocationEnded
public 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 |
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 über mehrere Geräte zu unterstützen.
Parameter | |
---|---|
context | IInvocationContext : Informationen zum Aufruf |
logAssociation
public 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. |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
Parameter | |
---|---|
enableGranularResults | boolean |
supportGranularResults
public boolean supportGranularResults ()
Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „False“.
Kehrt zurück | |
---|---|
boolean |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.
Muss vorERROR(/ITestInvocationListener#invocationFailed(Throwable))
oder ERROR(/ITestInvocationListener#invocationEnded(long))
aufgerufen werden. Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Protokoll und gegebenenfalls das Geräte-Logcat bereit.Parameter | |
---|---|
dataName | String : ein String der den Namen der Daten beschreibt. zB „device_logcat“. Beachten Sie, dass dataName pro Aufruf möglicherweise nicht eindeutig ist. Das heißt, Implementierer müssen in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten |
dataType | LogDataType : der LogDataType der Daten |
dataStream | InputStreamSource : die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und sicherstellen, dass der resultierende InputStream nach Abschluss geschlossen wird. Aufrufer sollten sicherstellen, dass die Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist. |
testLogSaved
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parameter | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
testModuleEnded
public void testModuleEnded ()
Meldet das Ende eines Modullaufs.
testModuleStarted
public 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 void testRunEnded (long elapsedTime,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 | |
---|---|
elapsedTime | long : Vom Gerät gemeldete verstrichene Zeit in Millisekunden |
runMetrics | Metric gemeldet werden. |
testRunFailed
public 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 void testRunFailed (String failureMessage)
Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
Parameter | |
---|---|
failureMessage | String : String , der den Grund für den Ausführungsfehler beschreibt. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Meldet den Start eines Testlaufs.
Parameter | |
---|---|
name | String : der Name des Testlaufs |
numTests | 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() |