CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
ITestInvocationListener,
ILogSaverListener
java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
Um ITestInvocationListener
que vai coletar todos os resultados do teste.
Embora as estruturas de dados usadas nesse objeto sejam seguras para linhas de execução, os callbacks ITestInvocationListener
precisam ser chamados na ordem correta.
Resumo
Construtores públicos | |
---|---|
CollectingTestListener()
|
Métodos públicos | |
---|---|
IBuildInfo
|
getBuildInfo()
Esse método foi descontinuado.
dependem do |
TestRunResult
|
getCurrentRunResults()
Recebe os resultados da execução do teste atual. |
int
|
getExpectedTests()
Retorna a contagem de testes esperada. |
IInvocationContext
|
getInvocationContext()
Retorna o contexto de invocação que foi informado por |
|
getMergedTestRunResults()
Retorna a coleção mesclada de resultados de todas as execuções em diferentes tentativas. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
Retorna o |
MultiMap<String, LogFile>
|
getModuleLogFiles()
Retorna uma cópia do mapa que contém todo o arquivo registrado associado ao módulo |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
Retorna uma cópia do mapa que contém todo o arquivo registrado não associado a uma execução de teste ou a um mais tarde neste módulo. |
int
|
getNumAllFailedTestRuns()
Retorna o número total de execuções de teste em estado de falha |
int
|
getNumAllFailedTests()
Retorna o número total de testes em estado de falha (somente com falha, as que não fazem parte do caso das falhas de suposição). serão contabilizados). |
int
|
getNumTestsInState(TestResult.TestStatus status)
Retorna o número de testes em determinado estado para esta execução. |
int
|
getNumTotalTests()
Retorna o número total de testes concluídos para todas as execuções. |
IBuildInfo
|
getPrimaryBuildInfo()
Retorna as informações do build principal que foram informadas pelo |
|
getRunResults()
Esse método foi descontinuado.
Usar o |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
Retorne o |
int
|
getTestRunAttemptCount(String testRunName)
Retorna o número de tentativas de um determinado nome de execução de teste. |
|
getTestRunAttempts(String testRunName)
Recebe todas as tentativas de um |
|
getTestRunForAttempts(int attempt)
Recebe todos os resultados de uma determinada tentativa. |
|
getTestRunNames()
Retorne todos os nomes de todas as execuções de teste. |
boolean
|
hasFailedTests()
Retorna se a invocação tiver algum teste com falha ou suposição que falhou. |
boolean
|
hasTestRunResultsForName(String testRunName)
Retorna se um determinado nome de execução de teste tem algum resultado. |
void
|
invocationEnded(long elapsedTime)
|
void
|
invocationFailed(Throwable cause)
|
void
|
invocationStarted(IInvocationContext context)
|
void
|
logAssociation(String dataName, LogFile logFile)
|
void
|
setBuildInfo(IBuildInfo buildInfo)
Esse método foi descontinuado. Não é mais necessário para testes. |
void
|
setMergeStrategy(MergeStrategy strategy)
Define o |
void
|
testAssumptionFailure(TestDescription test, String trace)
|
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
|
void
|
testEnded(TestDescription test, long endTime,
|
void
|
testEnded(TestDescription test,
|
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,
|
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)
|
Métodos protegidos | |
---|---|
final
void
|
clearModuleLogFiles()
Permite limpar o arquivo do módulo, evitando carregá-lo por muito tempo. |
final
void
|
clearResultsForName(String testRunName)
Permite limpar os resultados de um determinado nome de execução. |
void
|
setIsAggregrateMetrics(boolean aggregate)
Ative ou desative as "métricas agregadas" opção |
Construtores públicos
CollectingTestListener
public CollectingTestListener ()
Métodos públicos
getBuildInfo
public IBuildInfo getBuildInfo ()
Esse método foi descontinuado.
dependem da IBuildInfo
do getInvocationContext()
.
Retorna as informações do build.
Retorna | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Recebe os resultados da execução do teste atual.
Os resultados podem não estar completos. Recomendamos testar o valor de TestRunResult.isRunComplete()
e/ou (@link TestRunResult#isRunFailure()}, conforme apropriado)
antes de processar os resultados.
Retorna | |
---|---|
TestRunResult |
o TestRunResult que representa os dados coletados durante o último teste executado.
|
getesperadoTests
public int getExpectedTests ()
Retorna a contagem de testes esperada. Pode ser diferente de getNumTotalTests()
se
alguns testes não foram executados.
Retorna | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Retorna o contexto de invocação que foi informado por invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Retorna | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Retorna a coleção mesclada de resultados de todas as execuções em diferentes tentativas.
Se houver vários resultados, cada execução de teste será mesclada com o resultado mais recente. substituindo os resultados de testes de execuções anteriores. As execuções de teste são ordenadas pelo número de tentativas.
As métricas da mesma tentativa vão ser mescladas com base na preferência definida por aggregate-metrics
. As métricas finais serão as métricas da última tentativa.
Retorna | |
---|---|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Retorna o IInvocationContext
do módulo associado aos resultados.
Parâmetros | |
---|---|
testRunName |
String : o nome fornecido por {testRunStarted(String, int) . |
Retorna | |
---|---|
IInvocationContext |
O IInvocationContext do módulo para um determinado nome de execução de teste null
se não houver resultados para esse nome.
|
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Retorna uma cópia do mapa que contém todo o arquivo registrado associado ao módulo
Retorna | |
---|---|
MultiMap<String, LogFile> |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Retorna uma cópia do mapa que contém todo o arquivo registrado não associado a uma execução de teste ou a um mais tarde neste módulo.
Retorna | |
---|---|
MultiMap<String, LogFile> |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Retorna o número total de execuções de teste em estado de falha
Retorna | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Retorna o número total de testes em estado de falha (somente com falha, as que não fazem parte do caso das falhas de suposição). serão contabilizados).
Retorna | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus status)
Retorna o número de testes em determinado estado para esta execução.
Parâmetros | |
---|---|
status |
TestResult.TestStatus |
Retorna | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Retorna o número total de testes concluídos para todas as execuções.
Retorna | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Retorna as informações do build principal que foram informadas pelo invocationStarted(com.android.tradefed.invoker.IInvocationContext)
. O build primário é o build retornado pelo primeiro
provedor de build da configuração em execução. Retorna nulo se não houver contexto (nenhum build para
caso de teste).
Retorna | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Esse método foi descontinuado.
Usar getMergedTestRunResults()
Retorna os resultados de todas as execuções de teste.
Retorna | |
---|---|
|
getTestRunAtAttempt (getTestRunAtAttempt)
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Retorne o TestRunResult
para uma única tentativa.
Parâmetros | |
---|---|
testRunName |
String : o nome fornecido por {testRunStarted(String, int) . |
attempt |
int : o ID da tentativa. |
Retorna | |
---|---|
TestRunResult |
O TestRunResult do nome informado e o ID da tentativa ou o null , se
não existe.
|
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Retorna o número de tentativas de um determinado nome de execução de teste.
Parâmetros | |
---|---|
testRunName |
String : o nome fornecido por {testRunStarted(String, int) .
|
Retorna | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Recebe todas as tentativas de um TestRunResult
de uma determinada execução de teste.
Parâmetros | |
---|---|
testRunName |
String : o nome fornecido por {testRunStarted(String, int) . |
Retorna | |
---|---|
|
Todos os TestRunResult para uma determinada execução de teste, ordenados por tentativas.
|
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Recebe todos os resultados de uma determinada tentativa.
Parâmetros | |
---|---|
attempt |
int : a tentativa para que queremos resultados. |
Retorna | |
---|---|
|
Todos os TestRunResult para uma determinada tentativa.
|
getTestRunNames
publicgetTestRunNames ()
Retorne todos os nomes de todas as execuções de teste.
Esses testes podem ter sido executados várias vezes com tentativas diferentes.
Retorna | |
---|---|
|
hasFailedTests
public boolean hasFailedTests ()
Retorna se a invocação tiver algum teste com falha ou suposição que falhou.
Retorna | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Retorna se um determinado nome de execução de teste tem algum resultado.
Parâmetros | |
---|---|
testRunName |
String : o nome fornecido por {testRunStarted(String, int) .
|
Retorna | |
---|---|
boolean |
invocaçãoFinalizada
public void invocationEnded (long elapsedTime)
Parâmetros | |
---|---|
elapsedTime |
long |
InvocationFalha
public void invocationFailed (Throwable cause)
Parâmetros | |
---|---|
cause |
Throwable |
invocationStarted
public void invocationStarted (IInvocationContext context)
Parâmetros | |
---|---|
context |
IInvocationContext |
associação de registro
public void logAssociation (String dataName, LogFile logFile)
Parâmetros | |
---|---|
dataName |
String |
logFile |
LogFile |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Esse método foi descontinuado.
Não é mais necessário para testes.
Define as informações do build. Só deve ser usada para testes.
Parâmetros | |
---|---|
buildInfo |
IBuildInfo |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Define o MergeStrategy
a ser usado ao mesclar resultados.
Parâmetros | |
---|---|
strategy |
MergeStrategy |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Parâmetros | |
---|---|
test |
TestDescription |
trace |
String |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Parâmetros | |
---|---|
test |
TestDescription |
failure |
FailureDescription |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Parâmetros | |
---|---|
test |
TestDescription |
endTime |
long |
testMetrics |
|
testEnded
public void testEnded (TestDescription test,testMetrics)
Parâmetros | |
---|---|
test |
TestDescription |
testMetrics |
|
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Parâmetros | |
---|---|
test |
TestDescription |
failure |
FailureDescription |
testFailed
public void testFailed (TestDescription test, String trace)
Parâmetros | |
---|---|
test |
TestDescription |
trace |
String |
testIgnorado
public void testIgnored (TestDescription test)
Parâmetros | |
---|---|
test |
TestDescription |
testModuleEnded
public void testModuleEnded ()
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Parâmetros | |
---|---|
moduleContext |
IInvocationContext |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Parâmetros | |
---|---|
elapsedTime |
long |
runMetrics |
|
testRunFailed
public void testRunFailed (FailureDescription failure)
Parâmetros | |
---|---|
failure |
FailureDescription |
testRunFailed
public void testRunFailed (String errorMessage)
Parâmetros | |
---|---|
errorMessage |
String |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Parâmetros | |
---|---|
name |
String |
numTests |
int |
attemptNumber |
int |
testRunStarted
public void testRunStarted (String name, int numTests)
Parâmetros | |
---|---|
name |
String |
numTests |
int |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Parâmetros | |
---|---|
name |
String |
numTests |
int |
attemptNumber |
int |
startTime |
long |
testRunSStop
public void testRunStopped (long elapsedTime)
Parâmetros | |
---|---|
elapsedTime |
long |
testStarted
public void testStarted (TestDescription test, long startTime)
Parâmetros | |
---|---|
test |
TestDescription |
startTime |
long |
testStarted
public void testStarted (TestDescription test)
Parâmetros | |
---|---|
test |
TestDescription |
Métodos protegidos
ClearModuleLogFiles
protected final void clearModuleLogFiles ()
Permite limpar o arquivo do módulo, evitando carregá-lo por muito tempo.
limparResultadosParaNome
protected final void clearResultsForName (String testRunName)
Permite limpar os resultados de um determinado nome de execução. Só deve ser usado em alguns casos, como o agregador de resultados.
Parâmetros | |
---|---|
testRunName |
String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Ative ou desative as "métricas agregadas" opção
Parâmetros | |
---|---|
aggregate |
boolean |