ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
😎 com.android.tradefed.result.CollectingTestListener (in englischer Sprache)
  😎 com.android.tradefed.invoker.ShardListener.

Ein ITestInvocationListener, der Ergebnisse aus einem Aufruf-Shard erfasst (auch bekannt als Aufrufaufteilung zur parallelen Ausführung auf mehreren Ressourcen) und leitet sie an eine andere Listener.

Zusammenfassung

Öffentliche Konstruktoren

ShardListener(ITestInvocationListener main)

Erstellen Sie ein ShardListener.

Öffentliche Methoden

getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund eines Fehlers .

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

void invocationStarted(IInvocationContext context)

Meldet den Beginn des Testaufrufs.

void logAssociation(String dataName, LogFile logFile)

In einigen Fällen muss das Protokoll eng mit Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich.

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 Log- oder Debug-Daten aus dem Testaufruf bereit.

void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

void testModuleEnded()

Meldet das Ende einer Modulausführung.

void testModuleStarted(IInvocationContext moduleContext)

Meldet den Beginn eines laufenden Moduls.

void testRunEnded(long elapsedTime, runMetrics)

Ende des Testlaufs für Berichte.

void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines von FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

void testRunFailed(String failureMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

void testRunStarted(String name, int numTests, int attemptNumber, long startTime)

Meldet den Start eines Testlaufs.

Öffentliche Konstruktoren

ShardListener

public ShardListener (ITestInvocationListener main)

Erstellen Sie ein ShardListener.

Parameter
main ITestInvocationListener: die ITestInvocationListener, die weitergeleitet werden sollen. Um dies zu verhindern, Kollisionen mit anderen ShardListeners verursacht, wird dieses Objekt auf main beim Weiterleiten von Ergebnissen. Die Ergebnisse werden erst gesendet, Aufruf-Shard ist abgeschlossen.

Öffentliche Methoden

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Returns

Aufrufende beendet

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund eines Fehlers .

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long: die verstrichene Zeit des Aufrufs in ms

CallFailed (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

CallFailed (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

callSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
reason SkipReason

callStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen die um Berichte für mehrere Geräte zu erstellen.

Parameter
context IInvocationContext: Informationen zum Aufruf

LogAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich. Dieser Callback ermöglicht also eine starke Assoziation explizit auf.

Parameter
dataName String: der Name der Daten
logFile LogFile: LogFile, die zuvor protokolliert wurde und mit dem Testfall.

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

Returns
boolean

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Stellt die zugehörigen Log- oder Debug-Daten aus dem Testaufruf bereit.

Muss vor ERROR(/ITestInvocationListener#invocationFailed(Throwable)) aufgerufen werden oder ERROR(/ITestInvocationListener#invocationEnded(long))

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Protokoll bereit. und ggf. den Geräte-Logcat.

Parameter
dataName String: Ein beschreibender String-Name der Daten. z.B. „device_logcat“. Hinweis dataName darf pro Aufruf nicht eindeutig sein. d. h. Implementierungsteams müssen Mehrere Aufrufe mit demselben dataName
dataType LogDataType: die LogDataType der Daten
dataStream InputStreamSource: die InputStreamSource der Daten. Implementierungslösungen sollten createInputStream, um mit dem Lesen der Daten zu beginnen und sicherzustellen, dass das resultierende InputStream, wenn abgeschlossen ist. Anrufer sollten dafür sorgen, dass die Datenquelle nicht verloren geht. vorhanden und zugänglich sind, 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

TestModulBeendet

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn eines laufenden Moduls. Dieser Callback ist testModuleEnded() zugeordnet und in der Sequenz optional. Es wird nur während einer Ausführung verwendet, bei der Module: Suite-basierte Runner.

Parameter
moduleContext IInvocationContext: IInvocationContext des Moduls.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Ende des Testlaufs für Berichte. PROBLEM: Es können nicht zwei Karten verwendet werden.<> mit unterschiedlichen Typen. Wir müssen hier HashMap verwenden.

Parameter
elapsedTime long: Gerät hat die verstrichene Zeit in Millisekunden gemeldet
runMetrics : Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden.

testRunFailed (Testlauf fehlgeschlagen)

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines von FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

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

testRunFailed (Testlauf fehlgeschlagen)

public void testRunFailed (String failureMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
failureMessage String: String, die 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 der Testausführung
numTests int: Gesamtzahl der Tests im Testlauf
attemptNumber int: Bestellnummer, die die verschiedenen Versuche desselben runName-Elements identifiziert die mehrmals ausgeführt werden. Die "tryNumber" ist 0-indexiert und sollte jedes Mal erhöht werden, wenn ein neue Ausführung stattfindet. z.B. Ein Test ist detailliert 3-mal wiederholt und sollte insgesamt 4 Durchläufe umfassen. „runName“ und die „tryNumber“ liegt zwischen 0 und 3.
startTime long: der Zeitpunkt, zu dem die Ausführung gestartet wurde, gemessen über System.currentTimeMillis()