ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
😎 com.android.tradefed.result.ResultForwarder
  😎 com.android.tradefed.invoker.ShardMainResultForwarder

Ein ResultForwarder, der die Ergebnisse von fragmentierten Testaufrufen kombiniert. Nur sie meldet den Abschluss des Aufrufs an die Listener, sobald alle fragmentierten Aufrufe abgeschlossen sind.

Diese Klasse ist nicht threadsicher. Es wird erwartet, dass Clients diese Klasse sperren, wenn Senden von Testergebnissen, um zu verhindern, dass Aufrufrückrufe in der falschen Reihenfolge aufgerufen werden.

Zusammenfassung

Öffentliche Konstruktoren

ShardMainResultForwarder( listeners, int expectedShards)

Erstellen Sie ein ShardMainResultForwarder.

Öffentliche Methoden

getListeners()

Liste der Listener abrufen

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

Detaillierterer Callback, um zu unterscheiden, welches Shard abgeschlossen 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

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 testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

Leiten Sie nur das testLog weiter, anstatt das Protokoll vorher zu speichern.

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

Wird beim Speichern des Testprotokolls aufgerufen.

Öffentliche Konstruktoren

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Erstellen Sie ein ShardMainResultForwarder.

Parameter
listeners : Liste der ITestInvocationListener, an die Ergebnisse weitergeleitet werden sollen, wenn alle Shards sind abgeschlossen
expectedShards int: die Anzahl der Shards

Öffentliche Methoden

getListeners

public  getListeners ()

Liste der Listener abrufen Nur für Unterklassen vorgesehen.

Returns
Die Liste der ITestInvocationListeners.

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

Aufrufende beendet

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Detaillierterer Callback, um zu unterscheiden, welches Shard abgeschlossen wurde.

Parameter
elapsedTime long

context IInvocationContext

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.

testLogForward

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

Leiten Sie nur das testLog weiter, anstatt das Protokoll vorher zu speichern.

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Wird beim Speichern des Testprotokolls aufgerufen.

Sollte anstelle von ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) verwendet werden.

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.
logFile LogFile: LogFile mit den Metadaten der gespeicherten Datei