NomeMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.Oggetto | |
↳ | com.android.tradefed.result.NameMangleListener |
Un listener proxy per tradurre i nomi dei metodi, delle classi e dei pacchetti di test man mano che vengono riportati i risultati.
Riepilogo
Costruttori pubblici | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
Metodi pubblici | |
---|---|
TestSummary | getSummary () Consente a InvocationListener di restituire un riepilogo. |
void | invocationEnded (long elapsedTime) Segnala che la chiamata è stata terminata, con successo oa causa di qualche 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 | testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Riporta la fine dell'esecuzione di un singolo test case. |
void | testFailed ( TestDescription test, String trace) Segnala il fallimento di un singolo test case. |
void | testIgnored ( TestDescription test) 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 i dati di log o debug associati dalla chiamata di test. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Segnala la fine dell'esecuzione del test. |
void | testRunFailed (String errorMessage) L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile. |
void | testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStopped (long elapsedTime) Segnala l'interruzione dell'esecuzione del test prima del completamento a causa di una richiesta dell'utente. |
void | testStarted ( TestDescription test) Segnala l'inizio di un singolo test case. |
Metodi protetti | |
---|---|
TestDescription | mangleTestId ( TestDescription test) Questo metodo viene eseguito su tutti i |
String | mangleTestRunName (String name) Questo metodo viene eseguito su tutti i nomi di esecuzione dei test passati al callback |
Costruttori pubblici
NomeMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parametri | |
---|---|
listener | ITestInvocationListener |
Metodi pubblici
getSummary
public TestSummary getSummary ()
Consente a InvocationListener di restituire un riepilogo.
ritorna | |
---|---|
TestSummary | Un TestSummary che riepiloga l'esecuzione o null |
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 (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 |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack dell'errore |
testTerminato
public void testEnded (TestDescription test,testMetrics)
Riporta la fine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, questo test ha avuto esito positivo. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del caso di test.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testMetrics | ERROR(/Map) delle metriche emesse |
testFailed
public void testFailed (TestDescription test, String trace)
Segnala il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack dell'errore |
testIgnorato
public void testIgnored (TestDescription test)
Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
Parametri | |
---|---|
test | TestDescription : identifica il test |
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. |
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 (String errorMessage)
L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile.
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 prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
testRunStopped
public void testRunStopped (long elapsedTime)
Segnala l'interruzione dell'esecuzione del test prima del completamento a causa di una richiesta dell'utente.
TODO: attualmente inutilizzato, prendere in considerazione la rimozione
Parametri | |
---|---|
elapsedTime | long : tempo trascorso segnalato dal dispositivo, in millisecondi |
testAvviato
public void testStarted (TestDescription test)
Segnala l'inizio di un singolo test case. Interfaccia precedente, dovrebbe usare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test | TestDescription : identifica il test |
Metodi protetti
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Questo metodo viene eseguito su tutti i TestDescription
che vengono passati a testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
richiamate. Il metodo deve restituire una TestDescription
possibilmente diversa che verrà passata ITestInvocationListener
downstream specificato durante la costruzione.
L'implementazione deve fare attenzione a non modificare l'originale TestDescription
.
L'implementazione predefinita passa l'identificatore in entrata senza modificarlo.
Parametri | |
---|---|
test | TestDescription |
ritorna | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
Questo metodo viene eseguito su tutti i nomi di esecuzione dei test passati al callback testRunStarted(String, int)
. Il metodo dovrebbe restituire un nome di esecuzione del test possibilmente diverso che verrà passato ITestInvocationListener
downstream specificato durante la costruzione.
Parametri | |
---|---|
name | String |
ritorna | |
---|---|
String |