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 Shard-Testaufrufen kombiniert. Der Abschluss des Aufrufs wird den Listenern erst dann 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 Aufrufrückrufe außerhalb der Reihenfolge aufgerufen werden.

Zusammenfassung

Öffentliche Bauträger

ShardMainResultForwarder ( listeners, int expectedShards) ShardMainResultForwarder ( listeners, int expectedShards)

Erstellen Sie einen ShardMainResultForwarder .

Öffentliche Methoden

getListeners ()

Rufen Sie die Liste der Zuhörer ab.

void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf erfolgreich oder aufgrund einer Fehlerbedingung beendet wurde.

void invocationEnded (long elapsedTime, IInvocationContext context)

Detaillierterer Rückruf, um zu unterscheiden, welcher Shard fertiggestellt 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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Rückruf ist nicht möglich.

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

Leiten Sie das Testprotokoll nur weiter, anstatt das Protokoll zuerst zu speichern.

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

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Öffentliche Bauträger

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Erstellen Sie einen ShardMainResultForwarder .

Parameter
listeners : die Liste von ITestInvocationListener , an die Ergebnisse weitergeleitet werden sollen, wenn alle Shards abgeschlossen sind

expectedShards int : die Anzahl der Shards

Öffentliche Methoden

getListeners

public  getListeners ()

Rufen Sie die Liste der Zuhörer ab. Nur für die Verwendung durch Unterklassen vorgesehen.

Kehrt zurück
Die Liste der ITestInvocationListener s.

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Detaillierterer Rückruf, um zu unterscheiden, welcher Shard fertiggestellt wurde.

Parameter
elapsedTime long

context IInvocationContext

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.

testLogForward

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

Leiten Sie das Testprotokoll nur weiter, anstatt das Protokoll 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 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.

logFile LogFile : Das LogFile , das die Metadaten der gespeicherten Datei enthält.