Listener shard

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
🎞 com.android.tradefed.result.CollectingTestListener
  🎞 com.android.tradefed.invoker.ShardListener

Un elemento ITestInvocationListener che raccoglie i risultati da uno shard di chiamata (ovvero un la suddivisione della chiamata in modo che venga eseguita su più risorse in parallelo) e le inoltra a un'altra e ascolto.

Riepilogo

Costruttori pubblici

ShardListener(ITestInvocationListener main)

Crea un ShardListener.

Metodi pubblici

getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un errore .

void invocationFailed(FailureDescription failure)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

void invocationFailed(Throwable cause)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

void invocationSkipped(SkipReason reason)

Segnala una chiamata come saltata

void invocationStarted(IInvocationContext context)

Segnala l'inizio della chiamata di test.

void logAssociation(String dataName, LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile.

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Restituisce True se l'autore della segnalazione supporta risultati granulari, false negli altri casi.

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

Fornisce i dati di log o di 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)

Fine dell'esecuzione del test nei report.

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String failureMessage)

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

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

Segnala l'inizio di un'esecuzione di test.

Costruttori pubblici

Listener shard

public ShardListener (ITestInvocationListener main)

Crea un ShardListener.

Parametri
main ITestInvocationListener: il valore ITestInvocationListener a cui inviare i risultati. Per evitare collisioni con altri ShardListener, questo oggetto si sincronizzerà main durante l'inoltro dei risultati. I risultati verranno inviati una sola volta shard di chiamata completati.

Metodi pubblici

getunderlyingResultReporter

public  getUnderlyingResultReporter ()

Ritorni

chiamata terminata

public void invocationEnded (long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un errore .

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime long: il tempo trascorso della chiamata in ms

chiamata non riuscita

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

chiamata non riuscita

public void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause Throwable: la causa Throwable dell'errore

chiamataIgnorata

public void invocationSkipped (SkipReason reason)

Segnala una chiamata come saltata

Parametri
reason SkipReason

chiamataIniziata

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

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

Parametri
context IInvocationContext: informazioni sulla chiamata

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile. Pertanto, questo callback consente di fornire un'associazione in modo esplicito.

Parametri
dataName String: il nome dei dati
logFile LogFile: il valore LogFile registrato in precedenza e che deve essere associato al caso di test.

setSupportGranularRisultati

public void setSupportGranularResults (boolean enableGranularResults)

Parametri
enableGranularResults boolean

AssistenzaGranulari Risultati

public boolean supportGranularResults ()

Restituisce True se l'autore della segnalazione supporta risultati granulari, false negli altri casi.

Ritorni
boolean

Diariotest

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

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

La chiamata deve essere effettuata prima di ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oppure ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parametri
dataName String: un nome descrittivo String dei dati. ad es. "device_logcat". Nota dataName non può essere univoco per ogni chiamata. ovvero gli implementer devono essere in grado di più chiamate con lo stesso dataName
dataType LogDataType: il LogDataType dei dati
dataStream InputStreamSource: il InputStreamSource dei dati. Gli addetti all'implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream al termine. I chiamanti devono garantire che l'origine dei dati rimanga 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

testModuloTerminato

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuloIniziato

public void testModuleStarted (IInvocationContext moduleContext)

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

Parametri
moduleContext IInvocationContext: il IInvocationContext del modulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Fine dell'esecuzione del test nei report. FIXME: Non possiamo avere due mappe<> si interfaccia con tipi diversi, dobbiamo usare HashMap qui.

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

testRunNon riuscito

public void testRunFailed (FailureDescription failure)

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

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

testRunNon riuscito

public void testRunFailed (String failureMessage)

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

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
name String: 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 eseguite più volte. Il numero di tentativi è indicizzato a 0 e deve aumentare ogni volta che una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 esecuzioni. sotto lo stesso runName e il numero tentato è compreso tra 0 e 3.
startTime long: l'ora di inizio della corsa, misurata tramite System.currentTimeMillis()