ColetandoTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener , IDisableable

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

Subclasses diretas conhecidas JsonHttpTestResultReporter , LUCIResultReporter , MetricsXMLResultReporter , ModuleListener , ReportPassedTests , ResultAggregator , ShardListener , SuiteResultReporter , XmlResultReporter JsonHttpTestResultReporter Um repórter de resultados que codifica os resultados das métricas de teste e ramifica as informações do dispositivo em JSON e POST em um terminal de serviço HTTP LUCIResultReporter Um repórter de resultados que salva os resultados dos testes necessários para ResultDB e LUCI no formato JSON (go/result-sink) e registra o local do arquivo no console. MétricasXMLResultReporter MetricsXMLResultReporter grava métricas de teste e executa métricas em um arquivo XML em uma pasta especificada pelo parâmetro de pasta de métricas na fase invocationEnded do teste. MóduloListener Ouvinte anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados. Relatório de testes aprovados Informar em um arquivo possíveis filtros para excluir teste aprovado. Agregador de Resultados Forwarder especial que agrega os resultados quando necessário, com base na estratégia de repetição adotada. ShardListener Um ITestInvocationListener que coleta resultados de um fragmento de invocação (também conhecido como divisão de invocação para execução em vários recursos em paralelo) e os encaminha para outro ouvinte. SuiteResultReporter Colete os resultados dos testes para uma invocação de conjunto inteiro e produza os resultados finais. XmlResultReporter Grava resultados JUnit em arquivos XML em um formato consistente com XMLJUnitResultFormatter do Ant.

Subclasses indiretas conhecidas FormattedGeneratorReporter , XmlFormattedGeneratorReporter FormatadoGeneratorReporter Repórter que permite gerar relatórios em um formato específico. XmlFormattedGeneratorReporter A implementação do FormattedGeneratorReporter que formata o conjunto resulta em um formato xml.

---

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 IBuildInfo de getInvocationContext() .
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 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 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 invocationStarted(com.android.tradefed.invoker.IInvocationContext) .
	getRunResults () Este método está obsoleto. UsegetMergedTestRunResults 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 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 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) 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 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	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 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 .
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

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

public  getRunResults ()

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

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

getTestRunForAttempts

public  getTestRunForAttempts (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

public  getTestRunNames ()

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	: um 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	: 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 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	: pares de valores-chave 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 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