Esta página foi traduzida pela API Cloud Translation.

ColetandoTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

Subclasses diretas conhecidas

JsonHttpTestResultReporter , 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
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 (TestResult.TestStatus status)` Retorna o número de testes em determinado estado para esta execução.
`int`	`getNumTotalTests ()` Retorna o número total de testes concluídos para todas as execuções.
`IBuildInfo`	`getPrimaryBuildInfo ()` 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)`
`void`	`invocationFailed (Throwable cause)`
`void`	`invocationStarted (IInvocationContext context)`
`void`	`logAssociation (String dataName, LogFile logFile)`
`void`	`setBuildInfo (IBuildInfo buildInfo)` Este método está obsoleto. Não é mais necessário para testes.
`void`	`setMergeStrategy (MergeStrategy strategy)` Define o `MergeStrategy` a ser usado ao mesclar resultados.
`void`	`testAssumptionFailure (TestDescription test, String trace)`
`void`	`testAssumptionFailure (TestDescription test, FailureDescription failure)`
`void`	`testEnded (TestDescription test, long endTime, testMetrics)` `testEnded (TestDescription test, long endTime, testMetrics)`
`void`	`testEnded (TestDescription test, testMetrics)` `testEnded (TestDescription test, testMetrics)`
`void`	`testFailed (TestDescription test, FailureDescription failure)`
`void`	`testFailed (TestDescription test, String trace)`
`void`	`testIgnored (TestDescription test)`
`void`	`testModuleEnded ()`
`void`	`testModuleStarted (IInvocationContext moduleContext)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)`
`void`	`testRunFailed (FailureDescription failure)`
`void`	`testRunFailed (String errorMessage)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber)`
`void`	`testRunStarted (String name, int numTests)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped (long elapsedTime)`
`void`	`testStarted (TestDescription test, long startTime)`
`void`	`testStarted (TestDescription test)`

Métodos protegidos
`final void`	`clearModuleLogFiles ()` Permite limpar o arquivo do módulo 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 tentativas.

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

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

Parâmetros
`status`	`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)

Parâmetros
`elapsedTime`	`long`

invocaçãoFailed

public void invocationFailed (Throwable cause)

Parâmetros
`cause`	`Throwable`

invocaçãoiniciada

public void invocationStarted (IInvocationContext context)

Parâmetros
`context`	`IInvocationContext`

logAssociação

public void logAssociation (String dataName, 
                LogFile logFile)

Parâmetros
`dataName`	`String`
`logFile`	`LogFile`

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`

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)

Parâmetros
`test`	`TestDescription`
`trace`	`String`

testeAssunçãoFalha

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parâmetros
`test`	`TestDescription`
`failure`	`FailureDescription`

teste finalizado

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

Parâmetros
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

teste finalizado

public void testEnded (TestDescription test, 
                 testMetrics)

Parâmetros
`test`	`TestDescription`
`testMetrics`

teste falhou

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parâmetros
`test`	`TestDescription`
`failure`	`FailureDescription`

teste falhou

public void testFailed (TestDescription test, 
                String trace)

Parâmetros
`test`	`TestDescription`
`trace`	`String`

testeIgnorado

public void testIgnored (TestDescription test)

Parâmetros
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Parâmetros
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parâmetros
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Parâmetros
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parâmetros
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Parâmetros
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Parâmetros
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Parâmetros
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Parâmetros
`elapsedTime`	`long`

teste iniciado

public void testStarted (TestDescription test, 
                long startTime)

Parâmetros
`test`	`TestDescription`
`startTime`	`long`

teste iniciado

public void testStarted (TestDescription test)

Parâmetros
`test`	`TestDescription`

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`