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 delle chiamate di test partizionate. Segnala il completamento dell'invocazione agli ascoltatori solo una volta completate tutte le invocazioni partizionate.

Questa classe non è thread-safe. Si prevede che i client si blocchino su questa classe durante l'invio dei risultati del test, per evitare che i callback di invocazione vengano richiamati fuori servizio.

Riepilogo

Costruttori pubblici

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

Crea uno ShardMainResultForwarder .

Metodi pubblici

getListeners ()

Ottieni l'elenco degli ascoltatori.

void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con successo o a causa di qualche condizione di errore.

void invocationEnded (long elapsedTime, IInvocationContext context)

Richiamata più dettagliata per distinguere quale shard è terminato.

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

Segnala un'invocazione come saltata

void invocationStarted ( IInvocationContext context)

Riporta l'inizio dell'invocazione del test.

void logAssociation (String dataName, LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul comando diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la richiamata non è possibile.

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

Inoltra solo il testLog invece di salvare prima il registro.

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

Chiamato quando il registro del test viene salvato.

Costruttori pubblici

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Crea uno ShardMainResultForwarder .

Parametri
listeners : l'elenco di ITestInvocationListener a cui inoltrare i risultati quando tutti gli shard sono stati completati

expectedShards int : il numero di frammenti

Metodi pubblici

getListeners

public  getListeners ()

Ottieni l'elenco degli ascoltatori. Destinato solo all'uso da parte delle sottoclassi.

ritorna
L'elenco di ITestInvocationListener s.

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con successo o a causa di qualche condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Richiamata più dettagliata per distinguere quale shard è terminato.

Parametri
elapsedTime long

context IInvocationContext

invocazioneFailed

public void invocationFailed (FailureDescription failure)

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

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocazioneFailed

public void invocationFailed (Throwable cause)

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

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause Throwable : la causa Throwable del fallimento

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come saltata

Parametri
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Riporta l'inizio dell'invocazione del test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono sovrascrivere questo metodo per supportare la segnalazione di più dispositivi.

Parametri
context IInvocationContext : informazioni sull'invocazione

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul comando diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la richiamata non è possibile. Pertanto, questo callback consente di fornire esplicitamente un'associazione forte.

Parametri
dataName String : il nome dei dati

logFile LogFile : il LogFile che è stato registrato in precedenza e che dovrebbe essere associato al test case.

testLogForward

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

Inoltra solo il testLog invece di salvare prima il registro.

Parametri
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Chiamato quando il registro del test viene salvato.

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

Parametri
dataName String : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : il LogDataType dei dati

dataStream InputStreamSource : l' InputStreamSource dei dati. Gli implementatori dovrebbero chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante una volta completato.

logFile LogFile : il LogFile contenente i metadati del file salvato.