SubprocessResultsReporter
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Implementa ITestInvocationListener
da specificare come result_reporter e inoltrare dal sottoprocesso i risultati di test, esecuzioni di test e invocazioni di test.
Riepilogo
Costruttori pubblici | |
---|---|
SubprocessResultsReporter () |
Metodi pubblici | |
---|---|
void | close () |
TestSummary | getSummary () Consente a InvocationListener di restituire un riepilogo. |
void | invocationEnded (long elapsedTime) Segnala che l'invocazione è terminata, con successo o a causa di qualche condizione di errore. |
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 | 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 |
void | printEvent (String key, Object event) Helper per stampare la chiave dell'evento e quindi l'oggetto json. |
void | setOutputTestLog (boolean outputTestLog) Imposta se dobbiamo o meno emettere il test registrato o meno. |
boolean | supportGranularResults () Restituisce True se il reporter supporta risultati granulari, false altrimenti. |
void | testAssumptionFailure ( TestDescription testId, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Alternativa a |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Riporta la fine dell'esecuzione di un singolo test case. |
void | testFailed ( TestDescription testId, FailureDescription failure) Riporta il fallimento di un singolo test case. |
void | testFailed ( TestDescription testId, String reason) Riporta il fallimento di un singolo test case. |
void | testIgnored ( TestDescription testId) Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Fornisce il log associato o i dati di debug dalla chiamata del test. |
void | testModuleEnded () Segnala la fine dell'esecuzione di un modulo. |
void | testModuleStarted ( IInvocationContext moduleContext) Segnala l'inizio dell'esecuzione di un modulo. |
void | testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics) Segnala la fine dell'esecuzione del test. |
void | testRunFailed ( FailureDescription failure) Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da |
void | testRunFailed (String reason) Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStopped (long arg0) Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente. |
void | testStarted ( TestDescription testId, long startTime) Alternativa a |
void | testStarted ( TestDescription testId) Riporta l'inizio di un singolo caso di test. |
Costruttori pubblici
SubprocessResultsReporter
public SubprocessResultsReporter ()
Metodi pubblici
vicino
public void close ()
getSummary
public TestSummary getSummary ()
Consente a InvocationListener di restituire un riepilogo.
ritorna | |
---|---|
TestSummary | Oggetto TestSummary che riepiloga l'esecuzione oppure null |
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 |
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 |
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 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. |
printEvent
public void printEvent (String key, Object event)
Helper per stampare la chiave dell'evento e quindi l'oggetto json.
Parametri | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Imposta se dobbiamo o meno emettere il test registrato o meno.
Parametri | |
---|---|
outputTestLog | boolean |
supportGranularResults
public boolean supportGranularResults ()
Restituisce True se il reporter supporta risultati granulari, false altrimenti.
ritorna | |
---|---|
boolean |
testAssunzioneFailure
public void testAssumptionFailure (TestDescription testId, String trace)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
testId | TestDescription : identifica il test |
trace | String : traccia dello stack di errore |
testAssunzioneFailure
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
testId | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testEnded
public void testEnded (TestDescription testId, long endTime,metrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
dove possiamo specificare direttamente l'ora di fine. Combinalo con testStarted(com.android.tradefed.result.TestDescription, long)
per una misurazione accurata.
Parametri | |
---|---|
testId | TestDescription : identifica il test |
endTime | long : l'ora in cui è terminato il test, misurata tramite System.currentTimeMillis() |
metrics | ERROR(/Map) delle metriche emesse |
testEnded
public void testEnded (TestDescription testId,metrics)
Riporta la fine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, il test è stato superato. Restituisce inoltre qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.
Parametri | |
---|---|
testId | TestDescription : identifica il test |
metrics | ERROR(/Map) delle metriche emesse |
prova non riuscita
public void testFailed (TestDescription testId, FailureDescription failure)
Riporta il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
testId | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
prova non riuscita
public void testFailed (TestDescription testId, String reason)
Riporta il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
testId | TestDescription : identifica il test |
reason | String : traccia dello stack di errore |
testIgnorato
public void testIgnored (TestDescription testId)
Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
Parametri | |
---|---|
testId | TestDescription : identifica il test |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Fornisce il log associato o i dati di debug dalla chiamata del 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 : 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. I chiamanti devono garantire che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog. |
testModuleEnded
public void testModuleEnded ()
Segnala la fine dell'esecuzione di un modulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Segnala l'inizio dell'esecuzione di un modulo. 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 : l' IInvocationContext del modulo. |
testRunEnded
public void testRunEnded (long time,runMetrics)
Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.
Parametri | |
---|---|
time | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
Impossibile completare l'esecuzione del test dei report 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 reason)
Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile.
Parametri | |
---|---|
reason | String : String che descrive il motivo dell'errore di esecuzione. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
attemptNumber | int : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
attemptNumber | int : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3. |
startTime | long : l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long arg0)
Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.
TODO: attualmente inutilizzato, valuta la possibilità di rimuoverlo
Parametri | |
---|---|
arg0 | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
testAvviato
public void testStarted (TestDescription testId, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
per una misurazione accurata .
Parametri | |
---|---|
testId | TestDescription : identifica il test |
startTime | long : l'ora di inizio del test, misurata tramite System.currentTimeMillis() |
testAvviato
public void testStarted (TestDescription testId)
Riporta l'inizio di un singolo caso di test. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
testId | TestDescription : identifica il test |