RicevitoreITestLifeCycle
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Riceve notifiche di eventi durante le esecuzioni dei test di misurazione.
Modellato su org.junit.runner.notification.RunListener
La sequenza delle chiamate sarà:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testTerminato
- ....
- [testRunFailed]
- testRunEnded
Riepilogo
Metodi pubblici | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Viene chiamato quando un test atomico segnala che presuppone una condizione falsa |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Viene chiamato quando un test atomico segnala che presuppone una condizione falsa |
default
void
|
testEnded(TestDescription test, long endTime,
Alternativa a |
default
void
|
testEnded(TestDescription test,
Segnala il termine dell'esecuzione di un singolo test case. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Segnala l'errore di un singolo test case. |
default
void
|
testFailed(TestDescription test, String trace)
Segnala l'errore di un singolo test case. |
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,
Segnala la fine dell'esecuzione del test. |
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 del 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)
In alternativa a |
default
void
|
testStarted(TestDescription test)
Segnala l'inizio di un singolo test case. |
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 dell'errore |
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 direttamente l'ora di fine. Combina con testStarted(com.android.tradefed.result.TestDescription, long)
per una misurazione accurata.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
endTime |
long : l'ora di fine del test, misurata tramite System.currentTimeMillis() |
testMetrics |
: una percentuale pari a ERROR(/Map) delle metriche emesse |
testEnded
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 test, FailureDescription failure)
Segnala l'errore di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
failure |
FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testFailed
public void testFailed (TestDescription test, String trace)
Segnala l'errore di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test |
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 |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Fine dell'esecuzione del test nei report.
Parametri | |
---|---|
elapsedTimeMillis |
long : tempo trascorso segnalato dal dispositivo, in millisecondi |
runMetrics |
: coppie chiave-valore registrate al termine di un'esecuzione del test |
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. |
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, int attemptNumber)
Segnala l'inizio di un'esecuzione del test.
Parametri | |
---|---|
runName |
String : nome dell'esecuzione del test |
testCount |
int : numero totale di test nell'esecuzione di test |
attemptNumber |
int : numero d'ordine, che identifica i diversi tentativi dello stesso runName
eseguiti più volte. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Segnala l'inizio di un'esecuzione del test.
Parametri | |
---|---|
runName |
String : nome dell'esecuzione del test |
testCount |
int : numero totale di test nell'esecuzione di test |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione del test.
Parametri | |
---|---|
runName |
String : nome dell'esecuzione del test |
testCount |
int : numero totale di test nell'esecuzione di test |
attemptNumber |
int : numero ordine che identifica i diversi tentativi eseguiti dallo stesso runName
più volte. Il valore attemptNumber è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome runName e il valore attemptNumber deve essere compreso tra 0 e 3. |
startTime |
long : l'ora di inizio dell'esecuzione, 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 segnalato dal dispositivo, in millisecondi |
testIgnorato
public void testSkipped (TestDescription test, SkipReason reason)
Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
in cui viene specificato anche quando è stato avviato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
per una misurazione accurata.
Parametri | |
---|---|
test |
TestDescription : identifica il test |
startTime |
long : l'ora di inizio del test, misurata tramite System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
Segnala l'inizio di un singolo test case. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test |
TestDescription : identifica il test |