InvocationToJUnitResultForwarder
public
class
InvocationToJUnitResultForwarder
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.InvocationToJUnitResultForwarder |
Una classe che ascolta gli eventi ITestInvocationListener
e li inoltra a un
TestListener
.
Riepilogo
Costruttori pubblici | |
---|---|
InvocationToJUnitResultForwarder(TestListener junitListener)
|
Metodi pubblici | |
---|---|
TestSummary
|
getSummary()
Consente a InvocationListener di restituire un riepilogo. |
void
|
invocationEnded(long elapsedTime)
Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore. |
void
|
invocationFailed(Throwable cause)
Segnala una chiamata incompleta a causa di alcune condizioni di errore. |
void
|
invocationStarted(IInvocationContext context)
Segnala l'inizio dell'invocazione del test. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
Viene chiamato quando un test atomico segnala che presuppone una condizione falsa |
void
|
testEnded(TestDescription test,
Segnala il termine dell'esecuzione di un singolo test case. |
void
|
testFailed(TestDescription testId, String trace)
Segnala l'errore di un singolo scenario di test. |
void
|
testIgnored(TestDescription test)
Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore. |
void
|
testLog(String dataName, LogDataType logData, InputStreamSource dataStream)
Fornisce i dati di log o di debug associati dall'invocazione del test. |
void
|
testRunEnded(long elapsedTime,
Segnala la fine dell'esecuzione del test. |
void
|
testRunFailed(String errorMessage)
L'esecuzione del test dei report non è riuscita a causa di un errore fatale. |
void
|
testRunStarted(String runName, int testCount)
Segnala l'inizio di un'esecuzione del test. |
void
|
testRunStopped(long elapsedTime)
Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente. |
void
|
testStarted(TestDescription test)
Segnala l'inizio di un singolo test case. |
Metodi protetti | |
---|---|
TestListener
|
getJUnitListener()
|
Costruttori pubblici
InvocationToJUnitResultForwarder
public InvocationToJUnitResultForwarder (TestListener junitListener)
Parametri | |
---|---|
junitListener |
TestListener |
Metodi pubblici
getSummary
public TestSummary getSummary ()
Consente a InvocationListener di restituire un riepilogo.
Ritorni | |
---|---|
TestSummary |
Un elemento TestSummary che riassume l'esecuzione oppure un valore nullo |
chiamata terminata
public void invocationEnded (long elapsedTime)
Segnala che la chiamata è stata terminata, correttamente o a causa di una condizione di errore.
Verrà chiamato automaticamente dal framework TradeFederation.
Parametri | |
---|---|
elapsedTime |
long : il tempo trascorso dall'invocazione in ms |
invocationFailed
public void invocationFailed (Throwable cause)
Segnala un'invocazione incompleta a causa di una condizione di errore.
Verrà chiamato automaticamente dal framework TradeFederation.
Parametri | |
---|---|
cause |
Throwable : la causa Throwable dell'errore |
chiamataIniziata
public void invocationStarted (IInvocationContext context)
Segnala l'inizio dell'invocazione del test.
Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare i report su più dispositivi.
Parametri | |
---|---|
context |
IInvocationContext : informazioni sull'invocazione |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
testId |
TestDescription : identifica il test |
trace |
String : analisi dello stack dell'errore |
testTerminato
public void testEnded (TestDescription test,testMetrics)
Segnala il termine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato invocato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione del test case.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
testMetrics |
: un ERROR(/Map) delle metriche emesse |
testFailed
public void testFailed (TestDescription testId, String trace)
Segnala l'errore di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
testId |
TestDescription : identifica il test |
trace |
String : analisi dello stack dell'errore |
testIgnored
public void testIgnored (TestDescription test)
Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
testLog
public void testLog (String dataName, LogDataType logData, InputStreamSource dataStream)
Fornisce i dati di log o di debug associati dalla chiamata di test.
Deve essere chiamato prima del giorno 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 ogni chiamata. Ad esempio, gli implementatori devono essere in grado di gestire
più chiamate con lo stesso dataName |
logData |
LogDataType : il LogDataType dei dati |
dataStream |
InputStreamSource : il InputStreamSource dei dati. Gli strumenti di implementazione devono chiamare
createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante al completamento. Gli utenti che chiamano devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Fine dell'esecuzione del test nei report.
Parametri | |
---|---|
elapsedTime |
long : tempo trascorso segnalato dal dispositivo, in millisecondi |
runMetrics |
: coppie chiave/valore segnalate al termine dell'esecuzione di un test |
testRunFailed
public void testRunFailed (String errorMessage)
L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
Parametri | |
---|---|
errorMessage |
String : String che descrive il motivo dell'errore di esecuzione. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Segnala l'inizio di un'esecuzione di test.
Parametri | |
---|---|
runName |
String : il nome dell'esecuzione del test |
testCount |
int : numero totale di test nell'esecuzione di test |
testRunArrestato
public void testRunStopped (long elapsedTime)
L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
DA FARE: attualmente inutilizzato, valuta la possibilità di rimuoverlo
Parametri | |
---|---|
elapsedTime |
long : tempo trascorso sul dispositivo segnalato, in millisecondi |
testStarted
public void testStarted (TestDescription test)
Segnala l'inizio di un singolo test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription)
, se possibile.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
Metodi protetti
getJUnitListener
protected TestListener getJUnitListener ()
Ritorni | |
---|---|
TestListener |