ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Oggetto
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

---

Un ITestInvocationListener che raccoglie i risultati da un frammento di chiamata (ovvero una divisione di chiamata da eseguire su più risorse in parallelo) e li inoltra a un altro listener.

Riepilogo

Costruttori pubblici
ShardListener ( ITestInvocationListener main) Crea uno ShardListener .

Metodi pubblici
	getUnderlyingResultReporter ()
void	invocationEnded (long elapsedTime) Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore.
void	invocationFailed ( FailureDescription failure) Segnala una chiamata incompleta a causa di una condizione di errore.
void	invocationFailed (Throwable cause) Segnala una chiamata incompleta a causa di una condizione di errore.
void	invocationStarted ( IInvocationContext context) Segnala l'inizio della chiamata di test.
void	logAssociation (String dataName, LogFile logFile) In alcuni casi, log deve essere fortemente associato a un test case, ma l'opportunità di farlo direttamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la richiamata non è possibile.
void	setSupportGranularResults (boolean enableGranularResults)
boolean	supportGranularResults () Restituisce True se il reporter supporta risultati granulari, false in caso contrario.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Fornisce i dati di log o debug associati dalla chiamata di test.
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testModuleEnded () Segnala la fine dell'esecuzione di un modulo.
void	testModuleStarted ( IInvocationContext moduleContext) Segnala l'inizio di un modulo in esecuzione.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Segnala la fine dell'esecuzione del test.
void	testRunFailed ( FailureDescription failure) L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da FailureDescription .
void	testRunFailed (String failureMessage) L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile.
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di prova.

Costruttori pubblici

ShardListener

public ShardListener (ITestInvocationListener main)

Crea uno ShardListener .

Parametri
main	ITestInvocationListener : l' ITestInvocationListener i risultati devono essere inoltrati. Per evitare collisioni con altri ShardListener s, questo oggetto si sincronizzerà su main durante l'inoltro dei risultati. E i risultati verranno inviati solo una volta completato il frammento di chiamata.

Metodi pubblici

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

ritorna

invocazioneEnded

public void invocationEnded (long elapsedTime)

Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

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

invocazione non riuscita

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

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

invocazione non riuscita

public void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

Parametri
cause	Throwable : la causa Throwable del fallimento

invocazioneAvviato

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

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

Parametri
context	IInvocationContext : informazioni sulla chiamata

logAssociazione

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, log deve essere fortemente associato a un test case, ma l'opportunità di farlo direttamente 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 deve essere associato al test case.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parametri
enableGranularResults	boolean

supportGranularResults

public boolean supportGranularResults ()

Restituisce True se il reporter supporta risultati granulari, false in caso contrario.

ritorna
boolean

testLog

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

Fornisce i dati di log o debug associati dalla chiamata di test.

Deve essere chiamato prima di ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log dell'host e, se applicabile, il logcat del dispositivo.

Parametri
dataName	String : un nome descrittivo String dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName
dataType	LogDataType : il LogDataType dei dati
dataStream	InputStreamSource : InputStreamSource dei dati. Gli implementatori dovrebbero chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante al termine. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testLogSalvato

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

Parametri
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleAvviato

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante una corsa che utilizza moduli: corridori basati su suite.

Parametri
moduleContext	IInvocationContext : IInvocationContext del modulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test. FIXME: non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
elapsedTime	long : tempo trascorso segnalato dal dispositivo, in millisecondi
runMetrics	: coppie chiave-valore riportate al termine di un'esecuzione di test con Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da FailureDescription .

Parametri
failure	FailureDescription : FailureDescription che descrive l'errore e il relativo contesto.

testRunFailed

public void testRunFailed (String failureMessage)

L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile.

Parametri
failureMessage	String : String che descrive il motivo dell'errore di esecuzione.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Segnala l'inizio di un'esecuzione di prova.

Parametri
name	String : il nome dell'esecuzione del test
numTests	int : numero totale di test nell'esecuzione del test
attemptNumber	int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ritentato in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero di tentativi è compreso tra 0 e 3.
startTime	long : l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()