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 |
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 |
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 |
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
publicgetUnderlyingResultReporter ()
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 diERROR(/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 | 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() |