ColetandoTestListener
public class CollectingTestListener
extends Object
implements ITestInvocationListener , ILogSaverListener , IDisableable
java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
Um ITestInvocationListener
que coletará todos os resultados dos testes.
Embora as estruturas de dados usadas neste objeto sejam thread-safe, os retornos de chamada ITestInvocationListener
devem ser chamados na ordem correta.
Resumo
Construtores públicos | |
---|---|
CollectingTestListener () |
Métodos públicos | |
---|---|
IBuildInfo | getBuildInfo () Este método está obsoleto. conte com o |
TestRunResult | getCurrentRunResults () Obtém os resultados da execução de teste atual. |
int | getExpectedTests () Retorna a contagem do número de testes esperados. |
IInvocationContext | getInvocationContext () Retorne o contexto de invocação que foi relatado por meio de |
getMergedTestRunResults () Retorne a coleção mesclada de resultados para todas as execuções em diferentes tentativas. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Retorna o |
MultiMap <String, LogFile > | getModuleLogFiles () Retorna uma cópia do mapa contendo todos os arquivos registrados associados ao módulo |
MultiMap <String, LogFile > | getNonAssociatedLogFiles () Retorna uma cópia do mapa contendo todos os arquivos registrados não associados a uma execução de teste ou 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 falhas de suposição não contam). |
int | getNumTestsInState ( TestStatus status) Retorna o número de testes em determinado estado para esta execução. |
int | getNumTestsInState (TestResult.TestStatus ddmlibStatus) Para compatibilidade com tipo de status mais antigo |
int | getNumTotalTests () Retorna o número total de testes concluídos para todas as execuções. |
IBuildInfo | getPrimaryBuildInfo () Retorne as informações de compilação primária que foram relatadas por meio de |
getRunResults () Este método está obsoleto. UsegetMergedTestRunResults | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Retorne o |
int | getTestRunAttemptCount (String testRunName) Retorna o número de tentativas para um determinado nome de execução de teste. |
getTestRunAttempts (String testRunName) Obtém todas as tentativas de um | |
getTestRunForAttempts (int attempt) Obtém 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 teve 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) Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro. |
void | invocationFailed (Throwable cause) Relata uma invocação incompleta devido a alguma condição de erro. |
void | invocationSkipped ( SkipReason reason) Relata uma invocação como ignorada |
void | invocationStarted ( IInvocationContext context) Informa o início da chamada de teste. |
boolean | isDisabled () Retorna True se todo o objeto estiver desativado (ignore a configuração e a desmontagem). |
void | logAssociation (String dataName, LogFile logFile) Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente |
void | setBuildInfo ( IBuildInfo buildInfo) Este método está obsoleto. Não é mais necessário para testes. |
void | setDisable (boolean isDisabled) Define se o objeto deve ser desabilitado. |
void | setMergeStrategy ( MergeStrategy strategy) Define o |
void | testAssumptionFailure ( TestDescription test, String trace) Chamado quando um teste atômico sinaliza que assume uma condição falsa |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Chamado quando um teste atômico sinaliza que assume uma condição falsa |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa para |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Relata o final da execução de um caso de teste individual. |
void | testFailed ( TestDescription test, FailureDescription failure) Relata a falha de um caso de teste individual. |
void | testFailed ( TestDescription test, String trace) Relata a falha de um caso de teste individual. |
void | testIgnored ( TestDescription test) Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore. |
void | testModuleEnded () Informa o fim da execução de um módulo. |
void | testModuleStarted ( IInvocationContext moduleContext) Relata o início de um módulo em execução. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Informa o final da execução do teste. |
void | testRunFailed ( FailureDescription failure) A execução do teste de relatórios não foi concluída devido a uma falha descrita por |
void | testRunFailed (String errorMessage) A execução do teste de relatórios não foi concluída devido a um erro fatal. |
void | testRunStarted (String name, int numTests, int attemptNumber) Informa o início de uma execução de teste. |
void | testRunStarted (String name, int numTests) Informa o início de uma execução de teste. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Informa o início de uma execução de teste. |
void | testRunStopped (long elapsedTime) A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário. |
void | testSkipped ( TestDescription test, SkipReason reason) Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. |
void | testStarted ( TestDescription test, long startTime) Alternativa para |
void | testStarted ( TestDescription test) Relata o início de um caso de teste individual. |
Métodos protegidos | |
---|---|
final void | clearModuleLogFiles () Permite limpar o arquivo do módulo para evitar carregá-los por muito tempo. |
final void | clearResultsForName (String testRunName) Permite limpar os resultados para um determinado nome de execução. |
void | setIsAggregrateMetrics (boolean aggregate) Alterne a opção 'métricas agregadas' |
Construtores públicos
ColetandoTestListener
public CollectingTestListener ()
Métodos públicos
getBuildInfo
public IBuildInfo getBuildInfo ()
Este método está obsoleto.
conte com o IBuildInfo
de getInvocationContext()
.
Retorna as informações de construção.
Devoluções | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Obtém os resultados da execução de teste atual.
Observe que os resultados podem não estar completos. Recomenda-se testar o valor de TestRunResult.isRunComplete()
e/ou (@link TestRunResult#isRunFailure()} conforme apropriado antes de processar os resultados.
Devoluções | |
---|---|
TestRunResult | o TestRunResult representando os dados coletados durante a última execução de teste |
getExpectedTests
public int getExpectedTests ()
Retorna a contagem do número de testes esperados. Poderia ser diferente de getNumTotalTests()
se alguns testes não fossem executados.
Devoluções | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Retorne o contexto de invocação que foi relatado por meio de invocationStarted(com.android.tradefed.invoker.IInvocationContext)
Devoluções | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Retorne a coleção mesclada de resultados para todas as execuções em diferentes tentativas.
Se houver vários resultados, cada execução de teste será mesclada, com o resultado do teste mais recente substituindo os resultados dos testes de execuções anteriores. As execuções de teste são ordenadas por número de tentativa.
As métricas da mesma tentativa serão mescladas com base na preferência definida por aggregate-metrics
. As métricas finais serão as métricas da última tentativa.
Devoluções | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Retorna o IInvocationContext
do módulo associado aos resultados.
Parâmetros | |
---|---|
testRunName | String : O nome dado por { testRunStarted(String, int) . |
Devoluções | |
---|---|
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 contendo todos os arquivos registrados associados ao módulo
Devoluções | |
---|---|
MultiMap <String, LogFile > |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Retorna uma cópia do mapa contendo todos os arquivos registrados não associados a uma execução de teste ou módulo.
Devoluções | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Retorna o número total de execuções de teste em estado de falha
Devoluções | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Retorna o número total de testes em estado de falha (somente com falha, as falhas de suposição não contam).
Devoluções | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Retorna o número de testes em determinado estado para esta execução.
Parâmetros | |
---|---|
status | TestStatus |
Devoluções | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Para compatibilidade com tipo de status mais antigo
Parâmetros | |
---|---|
ddmlibStatus | TestResult.TestStatus |
Devoluções | |
---|---|
int |
getNumTotalTestes
public int getNumTotalTests ()
Retorna o número total de testes concluídos para todas as execuções.
Devoluções | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Retorne as informações de compilação primária que foram relatadas por meio de invocationStarted(com.android.tradefed.invoker.IInvocationContext)
. A compilação primária é a compilação retornada pelo primeiro provedor de compilação da configuração em execução. Retorna nulo se não houver contexto (sem construção para caso de teste).
Devoluções | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Este método está obsoleto.
UsegetMergedTestRunResults getMergedTestRunResults()
Retorna os resultados de todas as execuções de teste.
Devoluções | |
---|---|
getTestRunAtTempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Retorne o TestRunResult
para uma única tentativa.
Parâmetros | |
---|---|
testRunName | String : O nome dado por { testRunStarted(String, int) . |
attempt | int : o ID da tentativa. |
Devoluções | |
---|---|
TestRunResult | O TestRunResult para o nome fornecido e o ID da tentativa ou null se não existir. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Retorna o número de tentativas para um determinado nome de execução de teste.
Parâmetros | |
---|---|
testRunName | String : O nome dado por { testRunStarted(String, int) . |
Devoluções | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Obtém todas as tentativas de um TestRunResult
de uma determinada execução de teste.
Parâmetros | |
---|---|
testRunName | String : O nome dado por { testRunStarted(String, int) . |
Devoluções | |
---|---|
Todos TestRunResult de uma determinada execução de teste, ordenados por tentativas. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Obtém todos os resultados de uma determinada tentativa.
Parâmetros | |
---|---|
attempt | int : A tentativa para a qual queremos resultados. |
Devoluções | |
---|---|
Todos TestRunResult para uma determinada tentativa. |
getTestRunNames
publicgetTestRunNames ()
Retorne todos os nomes de todas as execuções de teste.
Essas execuções de teste podem ter sido executadas diversas vezes com tentativas diferentes.
Devoluções | |
---|---|
hasFailedTests
public boolean hasFailedTests ()
Retorna se a invocação teve algum teste com falha ou suposição que falhou.
Devoluções | |
---|---|
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 dado por { testRunStarted(String, int) . |
Devoluções | |
---|---|
boolean |
invocaçãoEnded
public void invocationEnded (long elapsedTime)
Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.
Será chamado automaticamente pelo framework TradeFederation.Parâmetros | |
---|---|
elapsedTime | long : o tempo decorrido da invocação em ms |
invocaçãoFailed
public void invocationFailed (Throwable cause)
Relata uma invocação incompleta devido a alguma condição de erro.
Será chamado automaticamente pelo framework TradeFederation.Parâmetros | |
---|---|
cause | Throwable : a causa Throwable da falha |
invocaçãoSkipped
public void invocationSkipped (SkipReason reason)
Relata uma invocação como ignorada
Parâmetros | |
---|---|
reason | SkipReason |
invocaçãoiniciada
public void invocationStarted (IInvocationContext context)
Informa o início da chamada de teste.
Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a relatórios de vários dispositivos.
Parâmetros | |
---|---|
context | IInvocationContext : informações sobre a invocação |
está desabilitado
public boolean isDisabled ()
Retorna True se todo o objeto estiver desativado (ignore a configuração e a desmontagem). Caso contrário, falso.
Devoluções | |
---|---|
boolean |
logAssociação
public void logAssociation (String dataName, LogFile logFile)
Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
não é possível. Assim, este retorno de chamada permite fornecer explicitamente uma associação forte.
Parâmetros | |
---|---|
dataName | String : O nome dos dados |
logFile | LogFile : o LogFile que foi logado anteriormente e deve ser associado ao caso de teste. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Este método está obsoleto.
Não é mais necessário para testes.
Defina as informações de compilação. Deve ser usado apenas para testes.
Parâmetros | |
---|---|
buildInfo | IBuildInfo |
definirDesativar
public void setDisable (boolean isDisabled)
Define se o objeto deve ser desabilitado. Desativado significa que as etapas de configuração e desmontagem devem ser ignoradas. Pode ser usado para desabilitar um objeto por padrão no construtor padrão.
Parâmetros | |
---|---|
isDisabled | boolean : o estado em que o objeto deve ser colocado. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Define o MergeStrategy
a ser usado ao mesclar resultados.
Parâmetros | |
---|---|
strategy | MergeStrategy |
testeAssunçãoFalha
public void testAssumptionFailure (TestDescription test, String trace)
Chamado quando um teste atômico sinaliza que assume uma condição falsa
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
trace | String : rastreamento de pilha de falha |
testeAssunçãoFalha
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Chamado quando um teste atômico sinaliza que assume uma condição falsa
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
failure | FailureDescription : FailureDescription que descreve a falha e seu contexto. |
teste finalizado
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
onde podemos especificar o horário de término diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long)
para uma medida precisa.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
endTime | long : o horário em que o teste terminou, medido via System.currentTimeMillis() |
testMetrics | ERROR(/Map) das métricas emitidas |
teste finalizado
public void testEnded (TestDescription test,testMetrics)
Relata o final da execução de um caso de teste individual.
Se testFailed(TestDescription, FailureDescription)
não foi invocado, este teste foi aprovado. Também retorna quaisquer métricas de chave/valor que possam ter sido emitidas durante a execução do caso de teste.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
testMetrics | ERROR(/Map) das métricas emitidas |
teste falhou
public void testFailed (TestDescription test, FailureDescription failure)
Relata a falha de um caso de teste individual.
Será chamado entre testStarted e testEnded.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
failure | FailureDescription : FailureDescription que descreve a falha e seu contexto. |
teste falhou
public void testFailed (TestDescription test, String trace)
Relata a falha de um caso de teste individual.
Será chamado entre testStarted e testEnded.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
trace | String : rastreamento de pilha de falha |
testeIgnorado
public void testIgnored (TestDescription test)
Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
testModuleEnded
public void testModuleEnded ()
Informa o fim da execução de um módulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Relata o início de um módulo em execução. Este retorno de chamada está associado a testModuleEnded()
e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em suíte.
Parâmetros | |
---|---|
moduleContext | IInvocationContext : o IInvocationContext do módulo. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Informa o final da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então temos que usar HashMap aqui.
Parâmetros | |
---|---|
elapsedTime | long : tempo decorrido relatado pelo dispositivo, em milissegundos |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
A execução do teste de relatórios não foi concluída devido a uma falha descrita por FailureDescription
.
Parâmetros | |
---|---|
failure | FailureDescription : FailureDescription que descreve a falha e seu contexto. |
testRunFailed
public void testRunFailed (String errorMessage)
A execução do teste de relatórios não foi concluída devido a um erro fatal.
Parâmetros | |
---|---|
errorMessage | String : String que descreve o motivo da falha na execução. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Informa o início de uma execução de teste.
Parâmetros | |
---|---|
name | String : o nome da execução de teste |
numTests | int : número total de testes em execução de teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3. |
testRunStarted
public void testRunStarted (String name, int numTests)
Informa o início de uma execução de teste.
Parâmetros | |
---|---|
name | String : o nome da execução de teste |
numTests | int : número total de testes em execução de teste |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Informa o início de uma execução de teste.
Parâmetros | |
---|---|
name | String : o nome da execução de teste |
numTests | int : número total de testes em execução de teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3. |
startTime | long : a hora em que a execução começou, medida via System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
TODO: atualmente não utilizado, considere remover
Parâmetros | |
---|---|
elapsedTime | long : tempo decorrido relatado pelo dispositivo, em milissegundos |
teste ignorado
public void testSkipped (TestDescription test, SkipReason reason)
Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. Esses testes serão tentados novamente para tentar obter uma execução adequada.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
reason | SkipReason : SkipReason |
teste iniciado
public void testStarted (TestDescription test, long startTime)
Alternativa para testStarted(com.android.tradefed.result.TestDescription)
onde também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para uma medida precisa .
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
startTime | long : a hora em que o teste começou, medido via System.currentTimeMillis() |
teste iniciado
public void testStarted (TestDescription test)
Relata o início de um caso de teste individual. Interface mais antiga, deve usar testStarted(com.android.tradefed.result.TestDescription)
sempre que possível.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
Métodos protegidos
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Permite limpar o arquivo do módulo para evitar carregá-los por muito tempo.
limparResultsForName
protected final void clearResultsForName (String testRunName)
Permite limpar os resultados para um determinado nome de execução. Deve ser utilizado apenas em alguns casos como agregador de resultados.
Parâmetros | |
---|---|
testRunName | String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Alterne a opção 'métricas agregadas'
Parâmetros | |
---|---|
aggregate | boolean |