RicevitoreITestLifeCycle
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleRicevitore |
Riceve notifiche di eventi durante le esecuzioni dei test della strumentazione.
Modello creato dopo org.junit.runner.notification.RunListener
La sequenza delle chiamate sarà:
- testRunStarted
- testIniziato
- [TestNon riuscito]
- [TestAssumptionFailure]
- [TestIgnorato]
- testTerminato
- ...
- [TestRunNon riuscito]
- testRunEnded
Riepilogo
Metodi pubblici | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Richiamato quando un test atomico segnala che assume una condizione falsa |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Richiamato quando un test atomico segnala che assume una condizione falsa |
default
void
|
testEnded(TestDescription test, long endTime,
Alternativa a |
default
void
|
testEnded(TestDescription test,
Segnala la fine dell'esecuzione di un singolo scenario di test. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Segnala l'errore di un singolo scenario di test. |
default
void
|
testFailed(TestDescription test, String trace)
Segnala l'errore di un singolo scenario di test. |
default
void
|
testIgnored(TestDescription test)
Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Fine dell'esecuzione del test nei report. |
default
void
|
testRunFailed(FailureDescription failure)
L'esecuzione del test dei report non è riuscita a causa di un errore descritto da |
default
void
|
testRunFailed(String errorMessage)
L'esecuzione del test dei report non è riuscita a causa di un errore irreversibile. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Segnala l'inizio di un'esecuzione di test. |
default
void
|
testRunStarted(String runName, int testCount)
Segnala l'inizio di un'esecuzione di test. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione di test. |
default
void
|
testRunStopped(long elapsedTime)
Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. |
default
void
|
testStarted(TestDescription test, long startTime)
Alternativa a |
default
void
|
testStarted(TestDescription test)
Segnala l'inizio di un singolo scenario di test. |
Metodi pubblici
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Richiamato quando un test atomico segnala che assume una condizione falsa
Parametri | |
---|---|
test |
TestDescription : identifica il test |
trace |
String : analisi dello stack degli errori |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Richiamato quando un test atomico segnala che assume una condizione falsa
Parametri | |
---|---|
test |
TestDescription : identifica il test |
failure |
FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testTerminato
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
in cui è possibile specificare l'ora di fine
strato Add. Combinalo con testStarted(com.android.tradefed.result.TestDescription, long)
per una misurazione accurata.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
endTime |
long : l'ora in cui è terminato il test, misurata tramite System.currentTimeMillis() |
testMetrics |
: una percentuale pari a ERROR(/Map) delle metriche emesse |
testTerminato
public void testEnded (TestDescription test,testMetrics)
Segnala la fine dell'esecuzione di un singolo scenario di test.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi coppia chiave-valore
metriche emesse durante l'esecuzione dello scenario di test.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
testMetrics |
: una percentuale pari a ERROR(/Map) delle metriche emesse |
testNon riuscito
public void testFailed (TestDescription test, FailureDescription failure)
Segnala l'errore di un singolo scenario di test.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
failure |
FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testNon riuscito
public void testFailed (TestDescription test, String trace)
Segnala l'errore di un singolo scenario di test.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
trace |
String : analisi dello stack degli errori |
testIgnorato
public void testIgnored (TestDescription test)
Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Fine dell'esecuzione del test nei report. FIXME: Non possiamo avere due mappe<> si interfaccia con tipi diversi, dobbiamo usare HashMap qui.
Parametri | |
---|---|
elapsedTimeMillis |
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 errorMessage)
L'esecuzione del test dei report non è riuscita a causa di un errore irreversibile.
Parametri | |
---|---|
errorMessage |
String : String che descrive il motivo dell'errore dell'esecuzione. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Segnala l'inizio di un'esecuzione di test.
Parametri | |
---|---|
runName |
String : nome dell'esecuzione del test |
testCount |
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 tentato è indicizzato a 0 e deve aumentare ogni volta
quando si verifica una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4
viene eseguito con lo stesso runName e il numero di tentativi è compreso tra 0 e 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Segnala l'inizio di un'esecuzione di test.
Parametri | |
---|---|
runName |
String : 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 test.
Parametri | |
---|---|
runName |
String : nome dell'esecuzione del test |
testCount |
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() |
testRunArrestato
public void testRunStopped (long elapsedTime)
Esecuzione di test dei report 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 |
testIgnorato
public void testSkipped (TestDescription test, SkipReason reason)
Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. Si cercherà di ritentare questi test per ottenere un'esecuzione corretta.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
reason |
SkipReason : SkipReason |
testIniziato
public void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
, dove specifichiamo anche quando il test è stato
iniziare, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
per una misurazione accurata.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
startTime |
long : l'ora in cui è iniziato il test, misurata tramite System.currentTimeMillis() |
testIniziato
public void testStarted (TestDescription test)
Segnala l'inizio di un singolo scenario di test. Interfaccia precedente; dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test |
TestDescription : identifica il test |