ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

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

Un ResultForwarder che combina i risultati di invocazioni di test suddivise in parti. Segnala il completamento dell'invocazione agli ascoltatori solo al termine di tutte le invocazioni suddivise in parti.

Questa classe non è sicura per i thread. È previsto che i client si blocchino su questa classe quando inviano i risultati del test per impedire che i callback di chiamata vengano chiamati fuori sequenza.

Riepilogo

Costruttori pubblici

ShardMainResultForwarder( listeners, int expectedShards)

Crea un ShardMainResultForwarder.

Metodi pubblici

getListeners()

Recupera l'elenco degli ascoltatori.

void invocationEnded(long elapsedTime)

Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.

void invocationEnded(long elapsedTime, IInvocationContext context)

Callback più dettagliato per distinguere quale shard è stato completato.

void invocationFailed(FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

void invocationFailed(Throwable cause)

Segnala un'invocazione incompleta a causa di una condizione di errore.

void invocationSkipped(SkipReason reason)

Segnala un'invocazione come ignorata

void invocationStarted(IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

void logAssociation(String dataName, LogFile logFile)

In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto.

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

Inoltra solo testLog anziché salvare prima il log.

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

Viene chiamato quando il log del test viene salvato.

Costruttori pubblici

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Crea un ShardMainResultForwarder.

Parametri
listeners : l'elenco di ITestInvocationListener a cui inoltrare i risultati al termine di tutti gli shard
expectedShards int: il numero di shard

Metodi pubblici

getListeners

public  getListeners ()

Recupera l'elenco degli ascoltatori. Destinato solo all'uso da parte di sottoclassi.

Ritorni
L'elenco di ITestInvocationListener.

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime long: il tempo trascorso dall'invocazione in ms

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Callback più dettagliato per distinguere quale shard è stato completato.

Parametri
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
failure FailureDescription: il FailureDescription che descrive la causa dell'errore

invocationFailed

public void invocationFailed (Throwable cause)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause Throwable: la causa Throwable dell'errore

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare i report su più dispositivi.

Parametri
context IInvocationContext: informazioni sull'invocazione

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto. Pertanto, questo callback consente di fornire un'associazione forte in modo esplicito.

Parametri
dataName String: il nome dei dati
logFile LogFile: il LogFile registrato in precedenza e da associare al test case.

testLogForward

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

Inoltra solo testLog anziché salvare prima il log.

Parametri
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Viene chiamato quando il log del test viene salvato.

Deve essere utilizzato al posto di ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

Parametri
dataName String: un nome descrittivo String dei dati, ad esempio "device_logcat". Nota: il nome dataName potrebbe non essere univoco per ogni chiamata. Ad esempio, gli implementatori devono essere in grado di gestire più chiamate con lo stesso nome dataName
dataType LogDataType: il LogDataType dei dati
dataStream InputStreamSource: il InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine.
logFile LogFile: il LogFile contenente i metadati del file salvato.