ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

Eine ResultForwarder, die die Ergebnisse von fragmentierten Testaufrufen kombiniert. Der Abschluss der Aufrufe wird den Listenern erst gemeldet, wenn alle ge shardeten Aufrufe abgeschlossen sind.

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

Zusammenfassung

Öffentliche Konstruktoren

ShardMainResultForwarder( listeners, int expectedShards)

Erstellen Sie eine ShardMainResultForwarder.

Öffentliche Methoden

getListeners()

Liste der Zuhörer abrufen

void invocationEnded(long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

void invocationEnded(long elapsedTime, IInvocationContext context)

Detaillierterer Rückruf, um zu unterscheiden, welcher Shard fertig ist.

void invocationFailed(FailureDescription failure)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

void invocationFailed(Throwable cause)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

void invocationSkipped(SkipReason reason)

Eine Aufrufung wird als übersprungen gemeldet.

void invocationStarted(IInvocationContext context)

Gibt den Beginn der Testausführung an.

void logAssociation(String dataName, LogFile logFile)

In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist.

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

Reichen Sie nur das Testprotokoll ein, anstatt es 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 ( listeners, 
                int expectedShards)

Erstellen Sie eine ShardMainResultForwarder.

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

Öffentliche Methoden

getListeners

public  getListeners ()

Liste der Zuhörer abrufen Nur für Unterklassen gedacht.

Returns
Die Liste der ITestInvocationListener.

invocationEnded

public void invocationEnded (long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long: die verstrichene Zeit seit der Aufrufung in ms

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Detaillierterer Rückruf, um zu unterscheiden, welcher Shard fertig ist.

Parameter
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
failure FailureDescription: die FailureDescription, die die Ursache des Fehlers beschreibt

invocationFailed

public void invocationFailed (Throwable cause)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
cause Throwable: die Throwable Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Eine Aufrufung wird als übersprungen gemeldet.

Parameter
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Gibt den Beginn der Testausführung an.

Wird automatisch vom TradeFederation-Framework aufgerufen. Meldende müssen diese Methode überschreiben, um Berichte zu mehreren Geräten zu unterstützen.

Parameter
context IInvocationContext: Informationen zur Aufrufung

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist. So kann mit diesem Rückruf eine starke Verknüpfung explizit angegeben werden.

Parameter
dataName String: Der Name der Daten
logFile LogFile: die zuvor protokollierte LogFile, die mit dem Testfall verknüpft werden soll.

testLogForward

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

Reichen Sie nur das Testprotokoll ein, anstatt es 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 für die Daten, z. B. „device_logcat“. Hinweis: „dataName“ muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also mehrere Aufrufe mit demselben „dataName“ verarbeiten können.
dataType LogDataType: die LogDataType der Daten
dataStream InputStreamSource: die InputStreamSource der Daten. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen.
logFile LogFile: die LogFile mit den Metadaten der gespeicherten Datei.