RaccoltaTestListener
public class CollectingTestListener
extends Object
implements ITestInvocationListener , ILogSaverListener , IDisableable
java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
Un ITestInvocationListener
che raccoglierà tutti i risultati dei test.
Sebbene le strutture dati utilizzate in questo oggetto siano thread-safe, i callback ITestInvocationListener
devono essere chiamati nell'ordine corretto.
Riepilogo
Costruttori pubblici | |
---|---|
CollectingTestListener () |
Metodi pubblici | |
---|---|
IBuildInfo | getBuildInfo () Questo metodo è deprecato. fare affidamento su |
TestRunResult | getCurrentRunResults () Ottiene i risultati per l'esecuzione del test corrente. |
int | getExpectedTests () Restituisce il numero di test previsti. |
IInvocationContext | getInvocationContext () Restituisce il contesto di invocazione segnalato tramite |
getMergedTestRunResults () Restituisce la raccolta unita di risultati per tutte le esecuzioni tra tentativi diversi. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Restituisce l' |
MultiMap <String, LogFile > | getModuleLogFiles () Restituisce una copia della mappa contenente tutti i file registrati associati al modulo |
MultiMap <String, LogFile > | getNonAssociatedLogFiles () Restituisce una copia della mappa contenente tutto il file registrato non associato a un'esecuzione di test o a un modulo. |
int | getNumAllFailedTestRuns () Restituisce il numero totale di esecuzioni di test in uno stato di errore |
int | getNumAllFailedTests () Restituisce il numero totale di test in uno stato di errore (solo falliti, i presupposti falliti non vengono conteggiati). |
int | getNumTestsInState (TestResult.TestStatus status) Restituisce il numero di test in un determinato stato per questa esecuzione. |
int | getNumTotalTests () Restituisce il numero totale di test completi per tutte le esecuzioni. |
IBuildInfo | getPrimaryBuildInfo () Restituisce le informazioni sulla build principale segnalate tramite |
getRunResults () Questo metodo è deprecato. Utilizza | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Restituisce |
int | getTestRunAttemptCount (String testRunName) Restituisce il numero di tentativi per un determinato nome di esecuzione del test. |
getTestRunAttempts (String testRunName) Ottiene tutti i tentativi per un | |
getTestRunForAttempts (int attempt) Ottiene tutti i risultati per un determinato tentativo. | |
getTestRunNames () Restituisce tutti i nomi per tutte le esecuzioni di test. | |
boolean | hasFailedTests () Restituisce se l'invocazione ha avuto dei test falliti o presuppone falliti. |
boolean | hasTestRunResultsForName (String testRunName) Restituisce se un determinato nome di esecuzione del test contiene risultati. |
void | invocationEnded (long elapsedTime) Segnala che l'invocazione è terminata, con successo o 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. |
boolean | isDisabled () Restituisce True se l'intero oggetto è disabilitato (salta sia la configurazione che lo smontaggio). |
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 | setBuildInfo ( IBuildInfo buildInfo) Questo metodo è deprecato. Non è più necessario per i test. |
void | setDisable (boolean isDisabled) Imposta se l'oggetto deve essere disabilitato. |
void | setMergeStrategy ( MergeStrategy strategy) Imposta |
void | testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Riporta la fine dell'esecuzione di un singolo test case. |
void | testFailed ( TestDescription test, FailureDescription failure) Riporta il fallimento di un singolo test case. |
void | testFailed ( TestDescription test, String trace) Riporta 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 | testModuleEnded () Segnala la fine dell'esecuzione di un modulo. |
void | testModuleStarted ( IInvocationContext moduleContext) Segnala l'inizio dell'esecuzione di un modulo. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, 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 errorMessage) Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile. |
void | testRunStarted (String name, int numTests, int attemptNumber) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStarted (String name, int numTests) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStopped (long elapsedTime) Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente. |
void | testStarted ( TestDescription test, long startTime) Alternativa a |
void | testStarted ( TestDescription test) Riporta l'inizio di un singolo caso di test. |
Metodi protetti | |
---|---|
final void | clearModuleLogFiles () Permette di pulire il file del modulo in modo da evitare di trasportarli troppo a lungo. |
final void | clearResultsForName (String testRunName) Consente di cancellare i risultati per un determinato nome di corsa. |
void | setIsAggregrateMetrics (boolean aggregate) Attiva/disattiva l'opzione "metriche aggregate". |
Costruttori pubblici
RaccoltaTestListener
public CollectingTestListener ()
Metodi pubblici
getBuildInfo
public IBuildInfo getBuildInfo ()
Questo metodo è deprecato.
fare affidamento su IBuildInfo
da getInvocationContext()
.
Restituisce le informazioni sulla compilazione.
ritorna | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Ottiene i risultati per l'esecuzione del test corrente.
Tieni presente che i risultati potrebbero non essere completi. Si consiglia di testare il valore di TestRunResult.isRunComplete()
e/o (@link TestRunResult#isRunFailure()} come appropriato prima di elaborare i risultati.
ritorna | |
---|---|
TestRunResult | il TestRunResult che rappresenta i dati raccolti durante l'ultima esecuzione del test |
getExpectedTest
public int getExpectedTests ()
Restituisce il numero di test previsti. Potrebbe differire da getNumTotalTests()
se alcuni test non vengono eseguiti.
ritorna | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Restituisce il contesto di invocazione segnalato tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext)
ritorna | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Restituisce la raccolta unita di risultati per tutte le esecuzioni tra tentativi diversi.
Se sono presenti più risultati, ogni esecuzione del test viene unita e il risultato del test più recente sovrascrive i risultati del test delle esecuzioni precedenti. Le esecuzioni dei test sono ordinate per numero di tentativi.
Le metriche per lo stesso tentativo verranno unite in base alla preferenza impostata da aggregate-metrics
. Le metriche finali saranno le metriche dell'ultimo tentativo.
ritorna | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Restituisce l' IInvocationContext
del modulo associato ai risultati.
Parametri | |
---|---|
testRunName | String : il nome dato da { testRunStarted(String, int) . |
ritorna | |
---|---|
IInvocationContext | L' IInvocationContext del modulo per un determinato nome di esecuzione del test null se non sono presenti risultati per quel nome. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Restituisce una copia della mappa contenente tutti i file registrati associati al modulo
ritorna | |
---|---|
MultiMap <String, LogFile > |
getFile di registro non associati
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Restituisce una copia della mappa contenente tutto il file registrato non associato a un'esecuzione di test o a un modulo.
ritorna | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Restituisce il numero totale di esecuzioni di test in uno stato di errore
ritorna | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Restituisce il numero totale di test in uno stato di errore (solo falliti, i presupposti falliti non vengono conteggiati).
ritorna | |
---|---|
int |
getNumTestInState
public int getNumTestsInState (TestResult.TestStatus status)
Restituisce il numero di test in un determinato stato per questa esecuzione.
Parametri | |
---|---|
status | TestResult.TestStatus |
ritorna | |
---|---|
int |
getNumTotalTest
public int getNumTotalTests ()
Restituisce il numero totale di test completi per tutte le esecuzioni.
ritorna | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Restituisce le informazioni sulla build principale segnalate tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext)
. La build primaria è la build restituita dal primo provider di build della configurazione in esecuzione. Restituisce null se non è presente alcun contesto (nessuna compilazione per testare il caso).
ritorna | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Questo metodo è deprecato.
Utilizza getMergedTestRunResults()
Restituisce i risultati per tutte le esecuzioni di test.
ritorna | |
---|---|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Restituisce TestRunResult
per un singolo tentativo.
Parametri | |
---|---|
testRunName | String : il nome dato da { testRunStarted(String, int) . |
attempt | int : il tentativo id. |
ritorna | |
---|---|
TestRunResult | TestRunResult per il nome specificato e ID tentativo o null se non esiste. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Restituisce il numero di tentativi per un determinato nome di esecuzione del test.
Parametri | |
---|---|
testRunName | String : il nome dato da { testRunStarted(String, int) . |
ritorna | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Ottiene tutti i tentativi per un TestRunResult
di una determinata esecuzione di test.
Parametri | |
---|---|
testRunName | String : il nome dato da { testRunStarted(String, int) . |
ritorna | |
---|---|
Tutti TestRunResult per una determinata esecuzione di test, ordinati per tentativi. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Ottiene tutti i risultati per un determinato tentativo.
Parametri | |
---|---|
attempt | int : il tentativo per il quale vogliamo risultati. |
ritorna | |
---|---|
Tutti TestRunResult per un determinato tentativo. |
getTestRunNames
publicgetTestRunNames ()
Restituisce tutti i nomi per tutte le esecuzioni di test.
Queste esecuzioni di test potrebbero essere state eseguite più volte con tentativi diversi.
ritorna | |
---|---|
hasFailedTests
public boolean hasFailedTests ()
Restituisce se l'invocazione ha avuto dei test falliti o presuppone falliti.
ritorna | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Restituisce se un determinato nome di esecuzione del test contiene risultati.
Parametri | |
---|---|
testRunName | String : il nome dato da { testRunStarted(String, int) . |
ritorna | |
---|---|
boolean |
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 (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 |
è disabilitato
public boolean isDisabled ()
Restituisce True se l'intero oggetto è disabilitato (salta sia la configurazione che lo smontaggio). Falso altrimenti.
ritorna | |
---|---|
boolean |
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. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Questo metodo è deprecato.
Non è più necessario per i test.
Imposta le informazioni sulla build. Dovrebbe essere utilizzato solo per i test.
Parametri | |
---|---|
buildInfo | IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Imposta se l'oggetto deve essere disabilitato. Disabilitato significa che sia la procedura di configurazione che quella di smontaggio devono essere saltate. Può essere utilizzato per rendere un oggetto disabilitato per impostazione predefinita nel costruttore predefinito.
Parametri | |
---|---|
isDisabled | boolean : lo stato in cui deve essere inserito l'oggetto. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Imposta MergeStrategy
da utilizzare durante l'unione dei risultati.
Parametri | |
---|---|
strategy | MergeStrategy |
testAssunzioneFallimento
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 di errore |
testAssunzioneFallimento
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
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 | |
---|---|
test | TestDescription : identifica il test |
endTime | long : l'ora in cui è terminato il test, misurata tramite System.currentTimeMillis() |
testMetrics | ERROR(/Map) delle metriche emesse |
testEnded
public void testEnded (TestDescription test,testMetrics)
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 | |
---|---|
test | TestDescription : identifica il test |
testMetrics | ERROR(/Map) delle metriche emesse |
prova non riuscita
public void testFailed (TestDescription test, FailureDescription failure)
Riporta il fallimento 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. |
prova non riuscita
public void testFailed (TestDescription test, String trace)
Riporta il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack di 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 |
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 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 : 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 errorMessage)
Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile.
Parametri | |
---|---|
errorMessage | String : String che descrive il motivo dell'errore di esecuzione. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
name | String : il nome dell'esecuzione del test |
numTests | 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 name, int numTests)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
name | String : il nome dell'esecuzione del test |
numTests | int : numero totale di test nell'esecuzione del test |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
name | String : il nome dell'esecuzione del test |
numTests | 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 elapsedTime)
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 | |
---|---|
elapsedTime | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
testAvviato
public void testStarted (TestDescription test, 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 | |
---|---|
test | TestDescription : identifica il test |
startTime | long : l'ora di inizio del test, misurata tramite System.currentTimeMillis() |
testAvviato
public void testStarted (TestDescription test)
Riporta l'inizio di un singolo caso di test. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test | TestDescription : identifica il test |
Metodi protetti
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Permette di pulire il file del modulo in modo da evitare di trasportarli troppo a lungo.
clearResultsForName
protected final void clearResultsForName (String testRunName)
Consente di cancellare i risultati per un determinato nome di corsa. Dovrebbe essere utilizzato solo in alcuni casi come aggregatore di risultati.
Parametri | |
---|---|
testRunName | String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Attiva/disattiva l'opzione "metriche aggregate".
Parametri | |
---|---|
aggregate | boolean |