RaccoltaTestListener
public class CollectingTestListener
extends Object
implements ITestInvocationListener, ILogSaverListener
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) |
void | invocationFailed (Throwable cause) |
void | invocationStarted (IInvocationContext context) |
void | logAssociation (String dataName, LogFile logFile) |
void | setBuildInfo (IBuildInfo buildInfo) Questo metodo è deprecato. Non è più necessario per i test. |
void | setMergeStrategy (MergeStrategy strategy) Imposta |
void | testAssumptionFailure (TestDescription test, String trace) |
void | testAssumptionFailure (TestDescription test, FailureDescription failure) |
void | testEnded (TestDescription test, long endTime, testMetrics) testEnded (TestDescription test, long endTime, testMetrics) |
void | testEnded (TestDescription test, testMetrics) testEnded (TestDescription test, testMetrics) |
void | testFailed (TestDescription test, FailureDescription failure) |
void | testFailed (TestDescription test, String trace) |
void | testIgnored (TestDescription test) |
void | testModuleEnded () |
void | testModuleStarted (IInvocationContext moduleContext) |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) |
void | testRunFailed (FailureDescription failure) |
void | testRunFailed (String errorMessage) |
void | testRunStarted (String name, int numTests, int attemptNumber) |
void | testRunStarted (String name, int numTests) |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) |
void | testRunStopped (long elapsedTime) |
void | testStarted (TestDescription test, long startTime) |
void | testStarted (TestDescription 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)
Parametri | |
---|---|
elapsedTime | long |
invocazioneFailed
public void invocationFailed (Throwable cause)
Parametri | |
---|---|
cause | Throwable |
invocationStarted
public void invocationStarted (IInvocationContext context)
Parametri | |
---|---|
context | IInvocationContext |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Parametri | |
---|---|
dataName | String |
logFile | LogFile |
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 |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Imposta MergeStrategy
da utilizzare durante l'unione dei risultati.
Parametri | |
---|---|
strategy | MergeStrategy |
testAssunzioneFailure
public void testAssumptionFailure (TestDescription test, String trace)
Parametri | |
---|---|
test | TestDescription |
trace | String |
testAssunzioneFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Parametri | |
---|---|
test | TestDescription |
failure | FailureDescription |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Parametri | |
---|---|
test | TestDescription |
endTime | long |
testMetrics |
testEnded
public void testEnded (TestDescription test,testMetrics)
Parametri | |
---|---|
test | TestDescription |
testMetrics |
prova non riuscita
public void testFailed (TestDescription test, FailureDescription failure)
Parametri | |
---|---|
test | TestDescription |
failure | FailureDescription |
prova non riuscita
public void testFailed (TestDescription test, String trace)
Parametri | |
---|---|
test | TestDescription |
trace | String |
testIgnorato
public void testIgnored (TestDescription test)
Parametri | |
---|---|
test | TestDescription |
testModuleEnded
public void testModuleEnded ()
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Parametri | |
---|---|
moduleContext | IInvocationContext |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Parametri | |
---|---|
elapsedTime | long |
runMetrics |
testRunFailed
public void testRunFailed (FailureDescription failure)
Parametri | |
---|---|
failure | FailureDescription |
testRunFailed
public void testRunFailed (String errorMessage)
Parametri | |
---|---|
errorMessage | String |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Parametri | |
---|---|
name | String |
numTests | int |
attemptNumber | int |
testRunStarted
public void testRunStarted (String name, int numTests)
Parametri | |
---|---|
name | String |
numTests | int |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Parametri | |
---|---|
name | String |
numTests | int |
attemptNumber | int |
startTime | long |
testRunStopped
public void testRunStopped (long elapsedTime)
Parametri | |
---|---|
elapsedTime | long |
testAvviato
public void testStarted (TestDescription test, long startTime)
Parametri | |
---|---|
test | TestDescription |
startTime | long |
testAvviato
public void testStarted (TestDescription test)
Parametri | |
---|---|
test | TestDescription |
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 |