CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener , IDisableable

java.lang.Object
com.android.tradefed.result.CollectingTestListener


Um ITestInvocationListener que coletará todos os resultados do teste.

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. confie no IBuildInfo de getInvocationContext() .

TestRunResult getCurrentRunResults ()

Obtém os resultados da execução de teste atual.

int getExpectedTests ()

Retorna o número de contagem de testes esperados.

IInvocationContext getInvocationContext ()

Retorne o contexto de invocação que foi relatado via invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

Retorne a coleção mesclada de resultados para todas as execuções em diferentes tentativas.

IInvocationContext getModuleContextForRunResult (String testRunName)

Retorna o IInvocationContext do módulo associado aos resultados.

MultiMap <String, LogFile > getModuleLogFiles ()

Retorna uma cópia do mapa contendo todo o arquivo logado associado ao módulo

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

Retorna uma cópia do mapa contendo todo o arquivo registrado não associado a uma execução de teste ou módulo.

int getNumAllFailedTestRuns ()

Retorna o número total de execuções de teste em um estado de falha

int getNumAllFailedTests ()

Retorna o número total de testes em um estado de falha (somente falhou, as falhas de suposição não contam para isso).

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 completos para todas as execuções.

IBuildInfo getPrimaryBuildInfo ()

Retorne as informações de compilação primária que foram relatadas por meio de invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

Este método está obsoleto. Use getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Retorne o TestRunResult para uma única tentativa.

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 TestRunResult de uma determinada execução de teste.

getTestRunForAttempts (int attempt)

Obtém todos os resultados para uma determinada tentativa.

getTestRunNames ()

Retorne todos os nomes para todas as execuções de teste.

boolean hasFailedTests ()

Retorna se a invocação teve algum teste com falha ou suposição com falha.

boolean hasTestRunResultsForName (String testRunName)

Retorna se um determinado nome de execução de teste tem algum resultado.

void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, seja com sucesso 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 invocationStarted ( IInvocationContext context)

Informa o início da chamada de teste.

boolean isDisabled ()

Retorna True se o objeto inteiro estiver desabilitado (ignore a configuração e 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 no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.

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 MergeStrategy a ser usado ao mesclar resultados.

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente.

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Informa o fim 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)

Informa o início da execução de um módulo.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Informa o fim da execução do teste.

void testRunFailed ( FailureDescription failure)

A execução do teste de relatórios falhou devido a uma falha descrita por FailureDescription .

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 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 medição precisa .

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 de um determinado nome de execução.

void setIsAggregrateMetrics (boolean aggregate)

Alternar a opção 'métricas agregadas'

Construtores públicos

CollectingTestListener

public CollectingTestListener ()

Métodos públicos

getBuildInfo

public IBuildInfo getBuildInfo ()

Este método está obsoleto.
confie no IBuildInfo de getInvocationContext() .

Retorna as informações de compilaçã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 do teste

getExpectedTests

public int getExpectedTests ()

Retorna o número de contagem de testes esperados. Pode diferir de getNumTotalTests() se alguns testes não forem executados.

devoluções
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorne o contexto de invocação que foi relatado via invocationStarted(com.android.tradefed.invoker.IInvocationContext)

devoluções
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

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 de teste das execuções anteriores. As execuções de teste são ordenadas por número de tentativa.

As métricas para a 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 todo o arquivo logado associado ao módulo

devoluções
MultiMap <String, LogFile >

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Retorna uma cópia do mapa contendo todo o arquivo registrado não associado 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 um estado de falha

devoluções
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Retorna o número total de testes em um estado de falha (somente falhou, as falhas de suposição não contam para isso).

devoluções
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

devoluções
int

getNumTotalTests

public int getNumTotalTests ()

Retorna o número total de testes completos 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 compilação para testar o caso).

devoluções
IBuildInfo

getRunResults

public  getRunResults ()

Este método está obsoleto.
Use getMergedTestRunResults()

Retorna os resultados de todas as execuções de teste.

devoluções

getTestRunAtAttempt

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 id de 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

public  getTestRunAttempts (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 para uma determinada execução de teste, ordenados por tentativas.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Obtém todos os resultados para uma determinada tentativa.

Parâmetros
attempt int : A tentativa para a qual queremos resultados.

devoluções
Todos TestRunResult para uma determinada tentativa.

getTestRunNames

public  getTestRunNames ()

Retorne todos os nomes para todas as execuções de teste.

Essas execuções de teste podem ter sido executadas várias vezes com diferentes tentativas.

devoluções

hasFailedTests

public boolean hasFailedTests ()

Retorna se a invocação teve algum teste com falha ou suposição com falha.

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çãoEncerrada

public void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, seja com sucesso ou devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
elapsedTime long : o tempo decorrido da invocação em ms

invocação falhou

public void invocationFailed (Throwable cause)

Relata uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
cause Throwable : a causa Throwable da falha

invocaçãoIniciado

public void invocationStarted (IInvocationContext context)

Informa o início da chamada de teste.

Será chamado automaticamente pela estrutura 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 o objeto inteiro estiver desabilitado (ignore a configuração e desmontagem). Falso caso contrário.

devoluções
boolean

logAssociation

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 no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, esse retorno de chamada permite fornecer explicitamente uma forte associação.

Parâmetros
dataName String : O nome dos dados

logFile LogFile : o LogFile que foi registrado antes 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

definir desabilitar

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 tornar um objeto desabilitado 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

testAssumptionFailure

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

testAssumptionFailure

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 descrevendo a falha e seu contexto.

testeFinalizado

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 : a hora em que o teste terminou, medido via System.currentTimeMillis()

testMetrics : um ERROR(/Map) das métricas emitidas

testeFinalizado

public void testEnded (TestDescription test, 
                 testMetrics)

Informa o fim da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi chamado, esse 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 : um 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 descrevendo 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)

Informa o início da execução de um módulo. Esse 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 suite.

Parâmetros
moduleContext IInvocationContext : o IInvocationContext do módulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim 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 : pares chave-valor relatados no final de uma execução de teste com Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

A execução do teste de relatórios falhou devido a uma falha descrita por FailureDescription .

Parâmetros
failure FailureDescription : FailureDescription descrevendo 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 do teste

numTests int : número total de testes na execução do teste

attemptNumber int : número do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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 do teste

numTests int : número total de testes na execução do 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 do teste

numTests int : número total de testes na execução do teste

attemptNumber int : número do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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

testStarted

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 medição precisa .

Parâmetros
test TestDescription : identifica o teste

startTime long : a hora em que o teste começou, medido via System.currentTimeMillis()

testStarted

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.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Permite limpar os resultados de um determinado nome de execução. Deve ser usado apenas em alguns casos como o agregador de resultados.

Parâmetros
testRunName String

setIsAggregateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Alternar a opção 'métricas agregadas'

Parâmetros
aggregate boolean