CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.CollectingTestListener |
Un ITestInvocationListener che raccoglierà tutti i risultati del test.
Sebbene le strutture di 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 è obsoleto.
affidati a |
TestRunResult
|
getCurrentRunResults()
Recupera i risultati dell'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 in tentativi diversi. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
Restituisce il |
MultiMap<String, LogFile>
|
getModuleLogFiles()
Restituisce una copia della mappa contenente tutti i file di log associati al modulo |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
Restituisce una copia della mappa contenente tutti i file registrati non associati a un'esecuzione di test o a un modulo. |
int
|
getNumAllFailedTestRuns()
Restituisce il numero totale di esecuzioni di test in stato di errore |
int
|
getNumAllFailedTests()
Restituisce il numero totale di test in stato di errore (solo errori, gli errori di ipotesi non vengono conteggiati). |
int
|
getNumTestsInState(TestStatus status)
Restituisce il numero di test nel determinato stato per questa esecuzione. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
Per la compatibilità con il tipo di stato precedente |
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 è obsoleto.
Usa |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
Restituisci |
int
|
getTestRunAttemptCount(String testRunName)
Restituisce il numero di tentativi per un determinato nome di esecuzione del test. |
|
getTestRunAttempts(String testRunName)
Recupera tutti i tentativi per un |
|
getTestRunForAttempts(int attempt)
Ottiene tutti i risultati per un determinato tentativo. |
|
getTestRunNames()
Restituisci tutti i nomi di tutte le esecuzioni del test. |
boolean
|
hasFailedTests()
Restituisce se la chiamata ha avuto test non riusciti o ipotesi non riuscite. |
boolean
|
hasTestRunResultsForName(String testRunName)
Restituisce un valore che indica se un determinato nome di esecuzione del test ha risultati. |
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 una condizione di errore. |
void
|
invocationSkipped(SkipReason reason)
Segnala un'invocazione come ignorata |
void
|
invocationStarted(IInvocationContext context)
Segnala l'inizio della chiamata di test. |
boolean
|
isDisabled()
Restituisce True se l'intero oggetto è disattivato (vengono ignorati sia la configurazione che l'eliminazione). |
void
|
logAssociation(String dataName, LogFile logFile)
In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo
nel callback diretto |
void
|
setBuildInfo(IBuildInfo buildInfo)
Questo metodo è obsoleto. Non è più necessario per i test. |
void
|
setDisable(boolean isDisabled)
Imposta se l'oggetto deve essere disattivato. |
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,
Alternativa a |
void
|
testEnded(TestDescription test,
Segnala la fine dell'esecuzione di un singolo scenario di test. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Segnala l'esito negativo di un singolo caso di test. |
void
|
testFailed(TestDescription test, String trace)
Segnala l'esito negativo di un singolo caso di test. |
void
|
testIgnored(TestDescription test)
Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore. |
void
|
testModuleEnded()
Segnala la fine dell'esecuzione di un modulo. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Indica l'inizio dell'esecuzione di un modulo. |
void
|
testRunEnded(long elapsedTime,
Segnala la fine dell'esecuzione del test. |
void
|
testRunFailed(FailureDescription failure)
L'esecuzione di test dei report non è stata completata a causa di un errore descritto da |
void
|
testRunFailed(String errorMessage)
L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile. |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
Segnala l'inizio di un'esecuzione del test. |
void
|
testRunStarted(String name, int numTests)
Segnala l'inizio di un'esecuzione del test. |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione del test. |
void
|
testRunStopped(long elapsedTime)
L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente. |
void
|
testSkipped(TestDescription test, SkipReason reason)
Chiamato quando un test viene ignorato e non eseguito per un motivo insolito. |
void
|
testStarted(TestDescription test, long startTime)
Alternativa a |
void
|
testStarted(TestDescription test)
Segnala l'inizio di un singolo scenario di test. |
Metodi protetti | |
|---|---|
final
void
|
clearModuleLogFiles()
Consente di pulire il file del modulo per evitare di conservarlo troppo a lungo. |
final
void
|
clearResultsForName(String testRunName)
Consente di cancellare i risultati per un determinato nome di esecuzione. |
final
void
|
clearTestRunResults()
Consente di cancellare tutti i risultati dell'esecuzione del test per evitare di conservarli troppo a lungo. |
void
|
setIsAggregrateMetrics(boolean aggregate)
Attiva/disattiva l'opzione "Aggrega metriche". |
Costruttori pubblici
CollectingTestListener
public CollectingTestListener ()
Metodi pubblici
getBuildInfo
public IBuildInfo getBuildInfo ()
Questo metodo è obsoleto.
affidati a IBuildInfo da getInvocationContext().
Restituisce le informazioni sulla build.
| Ritorni | |
|---|---|
IBuildInfo |
|
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Recupera i risultati dell'esecuzione del test corrente.
Tieni presente che i risultati potrebbero non essere completi. Ti consigliamo di testare il valore di TestRunResult.isRunComplete() e/o (@link TestRunResult#isRunFailure()} in base alle esigenze
prima di elaborare i risultati.
| Ritorni | |
|---|---|
TestRunResult |
il TestRunResult che rappresenta i dati raccolti durante l'ultima esecuzione del test |
getExpectedTests
public int getExpectedTests ()
Restituisce il numero di test previsti. Potrebbe differire da getNumTotalTests() se
alcuni test non sono stati eseguiti.
| Ritorni | |
|---|---|
int |
|
getInvocationContext
public IInvocationContext getInvocationContext ()
Restituisce il contesto di invocazione segnalato tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext)
| Ritorni | |
|---|---|
IInvocationContext |
|
getMergedTestRunResults
publicgetMergedTestRunResults ()
Restituisce la raccolta unita di risultati per tutte le esecuzioni in tentativi diversi.
Se sono presenti più risultati, ogni esecuzione del test viene unita e il risultato del test più recente sovrascrive i risultati dei test delle esecuzioni precedenti. Le esecuzioni di test sono ordinate in base al numero di tentativo.
Le metriche per lo stesso tentativo verranno unite in base alla preferenza impostata da aggregate-metrics. Le metriche finali saranno quelle dell'ultimo tentativo.
| Ritorni | |
|---|---|
|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Restituisce il IInvocationContext del modulo associato ai risultati.
| Parametri | |
|---|---|
testRunName |
String: il nome assegnato da {testRunStarted(String, int). |
| Ritorni | |
|---|---|
IInvocationContext |
Il 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 di log associati al modulo
| Ritorni | |
|---|---|
MultiMap<String, LogFile> |
|
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Restituisce una copia della mappa contenente tutti i file registrati non associati a un'esecuzione di test o a un modulo.
| Ritorni | |
|---|---|
MultiMap<String, LogFile> |
|
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Restituisce il numero totale di esecuzioni di test in stato di errore
| Ritorni | |
|---|---|
int |
|
getNumAllFailedTests
public int getNumAllFailedTests ()
Restituisce il numero totale di test in stato di errore (solo errori, gli errori di ipotesi non vengono conteggiati).
| Ritorni | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Restituisce il numero di test nel determinato stato per questa esecuzione.
| Parametri | |
|---|---|
status |
TestStatus |
| Ritorni | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Per la compatibilità con il tipo di stato precedente
| Parametri | |
|---|---|
ddmlibStatus |
TestResult.TestStatus |
| Ritorni | |
|---|---|
int |
|
getNumTotalTests
public int getNumTotalTests ()
Restituisce il numero totale di test completi per tutte le esecuzioni.
| Ritorni | |
|---|---|
int |
|
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Restituisce le informazioni sulla build principale segnalate tramite invocationStarted(com.android.tradefed.invoker.IInvocationContext). La build principale è la build restituita dal primo
provider di build della configurazione in esecuzione. Restituisce null se non è presente alcun contesto (nessuna build da
testare).
| Ritorni | |
|---|---|
IBuildInfo |
|
getRunResults
publicgetRunResults ()
Questo metodo è obsoleto.
Utilizza getMergedTestRunResults()
Restituisce i risultati di tutte le esecuzioni di test.
| Ritorni | |
|---|---|
|
|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Restituisci TestRunResult per un singolo tentativo.
| Parametri | |
|---|---|
testRunName |
String: il nome assegnato da {testRunStarted(String, int). |
attempt |
int: l'ID tentativo. |
| Ritorni | |
|---|---|
TestRunResult |
Il TestRunResult per il nome e l'ID tentativo specificati 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 assegnato da {testRunStarted(String, int). |
| Ritorni | |
|---|---|
int |
|
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Recupera tutti i tentativi per un TestRunResult di una determinata esecuzione del test.
| Parametri | |
|---|---|
testRunName |
String: il nome assegnato da {testRunStarted(String, int). |
| Ritorni | |
|---|---|
|
Tutti i TestRunResult per una determinata esecuzione del test, ordinati per tentativi. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Ottiene tutti i risultati per un determinato tentativo.
| Parametri | |
|---|---|
attempt |
int: Il tentativo per cui vogliamo i risultati. |
| Ritorni | |
|---|---|
|
Tutti i TestRunResult per un determinato tentativo. |
getTestRunNames
publicgetTestRunNames ()
Restituisci tutti i nomi di tutte le esecuzioni del test.
Queste esecuzioni di test potrebbero essere state eseguite più volte con tentativi diversi.
| Ritorni | |
|---|---|
|
|
hasFailedTests
public boolean hasFailedTests ()
Restituisce se la chiamata ha avuto test non riusciti o ipotesi non riuscite.
| Ritorni | |
|---|---|
boolean |
|
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Restituisce un valore che indica se un determinato nome di esecuzione del test ha risultati.
| Parametri | |
|---|---|
testRunName |
String: il nome assegnato da {testRunStarted(String, int). |
| Ritorni | |
|---|---|
boolean |
|
invocationEnded
public void invocationEnded (long elapsedTime)
Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
Verrà chiamato automaticamente dal framework TradeFederation.
| Parametri | |
|---|---|
elapsedTime |
long: il tempo trascorso dell'invocazione in ms |
invocationFailed
public void invocationFailed (Throwable cause)
Segnala una chiamata incompleta a causa di una condizione di errore.
Verrà chiamato automaticamente dal framework TradeFederation.
| Parametri | |
|---|---|
cause |
Throwable: la causa Throwable dell'errore |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Segnala un'invocazione come ignorata
| Parametri | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
Segnala l'inizio della chiamata di test.
Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare la segnalazione di più dispositivi.
| Parametri | |
|---|---|
context |
IInvocationContext: informazioni sulla chiamata |
isDisabled
public boolean isDisabled ()
Restituisce True se l'intero oggetto è disattivato (vengono ignorati sia la configurazione che l'eliminazione). Falso negli altri casi.
| Ritorni | |
|---|---|
boolean |
|
logAssociation
public void logAssociation (String dataName,
LogFile logFile)In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo
nel callback diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
non è possibile. Pertanto, questo callback consente di fornire un'associazione forte
in modo esplicito.
| Parametri | |
|---|---|
dataName |
String: il nome dei dati |
logFile |
LogFile: il LogFile registrato in precedenza e che deve essere associato allo scenario di test. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Questo metodo è obsoleto.
Non è più necessario per i test.
Imposta le informazioni sulla build. Deve essere utilizzato solo per i test.
| Parametri | |
|---|---|
buildInfo |
IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Imposta se l'oggetto deve essere disattivato. Disattivato significa che sia i passaggi di configurazione sia quelli di smontaggio devono essere ignorati. Può essere utilizzato per disabilitare un oggetto 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 |
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: analisi dello stack dell'errore |
testAssumptionFailure
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)) in cui possiamo 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 in cui è terminato il test, misurata tramite System.currentTimeMillis() |
testMetrics |
: un ERROR(/Map) delle metriche emesse |
testEnded
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 eventuali metriche chiave/valore
che potrebbero essere state emesse durante l'esecuzione dello scenario di test.
| Parametri | |
|---|---|
test |
TestDescription: identifica il test |
testMetrics |
: un ERROR(/Map) delle metriche emesse |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Segnala l'esito negativo di un singolo caso 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. |
testFailed
public void testFailed (TestDescription test, String trace)
Segnala l'esito negativo di un singolo caso di test.
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)
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 |
testModuleEnded
public void testModuleEnded ()
Segnala la fine dell'esecuzione di un modulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Indica l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza
moduli: runner basati su suite.
| Parametri | |
|---|---|
moduleContext |
IInvocationContext: il IInvocationContext del modulo. |
testRunEnded
public void testRunEnded (long elapsedTime,
runMetrics) Segnala la fine dell'esecuzione del test.
| Parametri | |
|---|---|
elapsedTime |
long: tempo trascorso segnalato dal dispositivo, in millisecondi |
runMetrics |
: coppie chiave-valore segnalate alla fine di un'esecuzione del test |
testRunFailed
public void testRunFailed (FailureDescription failure)
L'esecuzione di test dei report non è stata completata 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 è stata completata 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 del test.
| Parametri | |
|---|---|
name |
String: il nome dell'esecuzione di test |
numTests |
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. attemptNumber è indicizzato a 0 e deve aumentare ogni volta
che viene eseguita una nuova esecuzione. Ad esempio, un test viene riprovato in modo granulare 3 volte, deve avere 4 esecuzioni
totali con lo stesso runName e attemptNumber va da 0 a 3. |
testRunStarted
public void testRunStarted (String name,
int numTests)Segnala l'inizio di un'esecuzione del test.
| Parametri | |
|---|---|
name |
String: il nome dell'esecuzione di test |
numTests |
int: numero totale di test nell'esecuzione di test |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber,
long startTime)Segnala l'inizio di un'esecuzione del test.
| Parametri | |
|---|---|
name |
String: il nome dell'esecuzione di test |
numTests |
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. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che
viene eseguita una nuova esecuzione. Ad esempio, un test viene ritentato in modo granulare 3 volte, deve avere 4 esecuzioni totali
con lo stesso runName e attemptNumber va da 0 a 3. |
startTime |
long: l'ora in cui è iniziata la corsa, misurata tramite System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
TODO: attualmente non utilizzato, valuta la possibilità di rimuoverlo
| Parametri | |
|---|---|
elapsedTime |
long: tempo trascorso segnalato dal dispositivo, in millisecondi |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Chiamato quando un test viene ignorato e non eseguito per un motivo insolito. Verrà effettuato un nuovo tentativo di esecuzione di questi test.
| 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 specifichiamo anche quando è iniziato 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 scenario di test. Interfaccia precedente, deve utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.
| Parametri | |
|---|---|
test |
TestDescription: identifica il test |
Metodi protetti
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Consente di pulire il file del modulo per evitare di conservarlo troppo a lungo.
clearResultsForName
protected final void clearResultsForName (String testRunName)
Consente di cancellare i risultati per un determinato nome di esecuzione. Da utilizzare solo in alcuni casi, ad esempio l'aggregatore di risultati.
| Parametri | |
|---|---|
testRunName |
String |
clearTestRunResults
protected final void clearTestRunResults ()
Consente di cancellare tutti i risultati dell'esecuzione del test per evitare di conservarli troppo a lungo.
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Attiva/disattiva l'opzione "Aggrega metriche"
| Parametri | |
|---|---|
aggregate |
boolean |