ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

Ein ResultForwarder, in dem die Ergebnisse von fragmentierten Testaufrufen zusammengefasst werden. Die Fertigstellung des Aufrufs wird den Listenern erst gemeldet, wenn alle Shard-Aufrufe abgeschlossen sind.

Diese Klasse ist nicht threadsicher. Es wird erwartet, dass Clients diese Klasse beim Senden von Testergebnissen sperren, um zu verhindern, dass Aufruf-Callbacks in falscher Reihenfolge aufgerufen werden.

Zusammenfassung

Öffentliche Konstruktoren

ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)

Erstellen Sie einen ShardMainResultForwarder.

Öffentliche Methoden

List<ITestInvocationListener> getListeners()

Liste der Listener abrufen

void invocationEnded(long elapsedTime)

Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.

void invocationEnded(long elapsedTime, IInvocationContext context)

Detailliertere Rückrufaktion, um zu unterscheiden, welcher Shard abgeschlossen wurde.

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 logFile)

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.

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

Leiten Sie nur das testLog weiter, anstatt das Log zuerst zu speichern.

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

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Öffentliche Konstruktoren

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

Erstellen Sie einen ShardMainResultForwarder.

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

Öffentliche Methoden

getListeners

public List<ITestInvocationListener> getListeners ()

Liste der Listener abrufen

Gibt Folgendes zurück:
List<ITestInvocationListener> Die Liste der ITestInvocationListeners.

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Detailliertere Rückrufaktion, um zu unterscheiden, welcher Shard abgeschlossen wurde.

Parameter
elapsedTime long

context IInvocationContext

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 logFile)

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
logFile LogFile: Die LogFile, die zuvor protokolliert wurde und dem Testlauf zugeordnet werden soll.

testLogForward

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

Leiten Sie nur das testLog weiter, anstatt das Log zuerst zu speichern.

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

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

Parameter
dataName String: Ein String aussagekräftiger Name der Daten, z. B. „device_logcat“. Hinweis: dataName ist möglicherweise nicht eindeutig pro Aufruf. Implementierer müssen also mehrere Aufrufe mit demselben dataName verarbeiten können.
dataType LogDataType: die LogDataType der Daten
dataStream InputStreamSource: die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream schließen, wenn sie fertig sind.
logFile LogFile: das LogFile mit den Metadaten der gespeicherten Datei.