CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

Subclasses diretas conhecidas JsonHttpTestResultReporter, LUCIResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter e XmlResultReporter JsonHttpTestResultReporter (link em inglês) Um gerador de relatórios de resultados que codifica os resultados das métricas de teste e as informações do dispositivo em ramificações e JSON e POST. em um endpoint do serviço HTTP LUCIResultReporter (link em inglês) Um gerador de relatórios de resultados que salva os resultados necessários para o ResultDB e a LUCI. no formato JSON (go/result-sink) e registra a localização do arquivo no console.  MetricsXMLResultReporter (em inglês) MetricsXMLResultReporter grava métricas de teste e executa métricas em um arquivo XML na pasta especificada. pelo parâmetro metrics-folder na fase invocationEnded do teste.  ModuleListener (link em inglês) Listener anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados.  ReportPassedTests (link em inglês) Informe em um arquivo possíveis filtros para excluir a aprovação no teste.  ResultAggregator (link em inglês) Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de repetição que foi tomadas.  ShardListener (link em inglês) Um ITestInvocationListener que coleta resultados de um fragmento de invocação (também conhecido como divisão de invocação para ser executada em vários recursos em paralelo) e os encaminha para outro ouvinte.  SuiteResultReporter (link em inglês) Colete os resultados do teste de uma invocação de conjunto inteira e gere os resultados finais.  XmlResultReporter (link em inglês) Grava resultados do JUnit em um arquivo XML em um formato consistente com XMLJUnitResultFormatter do Ant.

Subclasses indiretas conhecidas FormattedGeneratorReporter, XmlFormattedGeneratorReporter FormattedGeneratorReporter (link em inglês) Repórter que permite gerar relatórios em um formato específico.  XmlFormattedGeneratorReporter (link em inglês) Implementação do FormattedGeneratorReporter, que formata o pacote resulta em um XML .

---

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 IBuildInfo de getInvocationContext().
TestRunResult	getCurrentRunResults() Recebe os resultados da execução de teste atual.
int	getExpectedTests() Retorna a contagem de testes esperada.
IInvocationContext	getInvocationContext() Retorna o contexto de invocação que foi informado por invocationStarted(com.android.tradefed.invoker.IInvocationContext).
	getMergedTestRunResults() Retorna a coleção mesclada de resultados de 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 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(TestStatus status) Retorna o número de testes em determinado estado para esta execução.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) Para compatibilidade com tipos de status mais antigos
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 invocationStarted(com.android.tradefed.invoker.IInvocationContext).
	getRunResults() Esse método foi descontinuado. Usar o getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt(String testRunName, int attempt) Retorne o TestRunResult para uma única tentativa.
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 TestRunResult de uma determinada execução de teste.
	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) Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição.
void	invocationFailed(Throwable cause) Informa uma invocação incompleta devido a uma condição de erro.
void	invocationSkipped(SkipReason reason) Informa uma invocação como "ignorada"
void	invocationStarted(IInvocationContext context) Informa o início da invocação do teste.
boolean	isDisabled() Retorna "True" se o objeto inteiro estiver desativado (ignorar a configuração e a eliminação).
void	logAssociation(String dataName, LogFile logFile) Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível.
void	setBuildInfo(IBuildInfo buildInfo) Esse método foi descontinuado. Não é mais necessário para testes.
void	setDisable(boolean isDisabled) Define se o objeto deve ser desativado.
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) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), em que podemos especificar o horário de término diretamente.
void	testEnded(TestDescription test, testMetrics) Informa 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 é executado, geralmente porque um método de teste é anotado com "org.junit.Ignore".
void	testModuleEnded() Informa o final de uma execução de módulo.
void	testModuleStarted(IInvocationContext moduleContext) Informa o início de um módulo em execução.
void	testRunEnded(long elapsedTime, runMetrics) Informa o fim 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 executado por um motivo que normalmente não é esperado.
void	testStarted(TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para uma medição precisa.
void	testStarted(TestDescription test) Informa o início de um caso de teste individual.

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

public  getMergedTestRunResults ()

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 (TestStatus status)

Retorna o número de testes em determinado estado para esta execução.

Parâmetros
status	TestStatus

Retorna
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Para compatibilidade com tipos de status mais antigos

Parâmetros
ddmlibStatus	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

public  getRunResults ()

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

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

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

public  getTestRunNames ()

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)

Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição.

Será chamado automaticamente pela estrutura TradeFederation.

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

InvocationFailed

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
cause	Throwable: a causa Throwable da falha.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa uma invocação como "ignorada"

Parâmetros
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa o início da invocação do teste.

Será chamado automaticamente pela estrutura TradeFederation. Os informantes precisam substituir esse método para oferecer suporte à geração de relatórios de vários dispositivos.

Parâmetros
context	IInvocationContext: informações sobre a invocação.

Desativado

public boolean isDisabled ()

Retorna "True" se o objeto inteiro estiver desativado (ignorar a configuração e a eliminação). Falso, do contrário.

Retorna
boolean

associação de registro

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível. Assim, esse callback permite fornecer uma associação forte explicitamente.

Parâmetros
dataName	String: o nome dos dados
logFile	LogFile: o LogFile que foi registrado antes e precisa ser associado ao caso de teste.

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

setDesativar

public void setDisable (boolean isDisabled)

Define se o objeto deve ser desativado. "Desativado" significa que as etapas de configuração e desmontagem deve ser ignorada. Pode ser usado para tornar um objeto desativado por padrão no construtor.

Parâmetros
isDisabled	boolean: o estado em que o objeto precisa 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: stack trace 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 o contexto.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), em que podemos especificar o horário de término diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long) para uma medição precisa.

Parâmetros
test	TestDescription: identifica o teste.
endTime	long: o horário de término do teste, medido por System.currentTimeMillis().
testMetrics	: um ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna qualquer chave/valor métricas que podem 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

testFailed

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 o contexto.

testFailed

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: stack trace de falha

testIgnorado

public void testIgnored (TestDescription test)

Chamado quando um teste não é 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 final de uma execução de módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa o início de um módulo em execução. Esse callback está associado a testModuleEnded() e é opcional na sequência. Ela só é usada durante uma execução que usa módulos: executores baseados em pacote.

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 dois Map<> interfaces com tipos diferentes, então precisamos usar o HashMap aqui.

Parâmetros
elapsedTime	long: tempo decorrido informado pelo dispositivo, em milissegundos.
runMetrics	: pares de chave-valor informados no final de um 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 descrevendo a falha e o 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 descrevendo 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 na execução do teste
attemptNumber	int: número do pedido, identificando as diferentes tentativas do mesmo runName executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado todas as vezes ocorre uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro no total é executado com o mesmo runName, e o tryNumber varia 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 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 de 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 executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado sempre que um uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro execuções no total com o mesmo runName, e o tryNumber vai de 0 a 3.
startTime	long: o horário de início da corrida, medida usando System.currentTimeMillis().

testRunSinterrupto

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: não usado no momento, considere remover

Parâmetros
elapsedTime	long: tempo decorrido informado pelo dispositivo, em milissegundos.

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. Tentaremos realizar esses testes novamente para tentar obter uma execução adequada.

Parâmetros
test	TestDescription: identifica o teste.
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para uma medição precisa.

Parâmetros
test	TestDescription: identifica o teste.
startTime	long: o horário de início do teste, medido por System.currentTimeMillis().

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. A interface mais antiga precisa 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, 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