Esta página foi traduzida pela API Cloud Translation.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subclasses diretas conhecidas

FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer

FilteredResultForwarder	Variante de `ResultForwarder` que permite que apenas uma lista de permissões de `TestDescription` seja relatada.
JarHostTest.HostTestListener	Ouvinte wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded(), para o ouvinte incorporado.
LogSaverResultForwarder	Um `ResultForwarder` para salvar logs com o protetor de arquivo global.
LogcatCrashResultForwarder	Ouvinte especial: em falhas (travamento do processo de instrumentação) tentará extrair do logcat o travamento e adicioná-lo à mensagem de falha associada ao teste.
PythonBinaryHostTest.PythonForwarder	Encaminhador de resultados para substituir o nome da execução pelo nome binário.
ResultAndLogForwarder	Forwarder para resultados e eventos de logs.
RetryResultForwarder	Uma extensão de `ResultForwarder` que sempre envia para um determinado número de tentativa.
ShardMainResultForwarder	Um `ResultForwarder` que combina os resultados de invocações de teste fragmentado.
TestTimeoutEnforcer	Ouvintes que permitem verificar o tempo de execução de um determinado caso de teste e reprová-lo se ultrapassar um determinado tempo limite.

Subclasses indiretas conhecidas

GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Auxiliar de classe para capturar o início e o fim da execução ausente.
RetryLogSaverResultForwarder	Encaminhador que também lida com a passagem da tentativa atual em que estamos.

Um ITestInvocationListener que encaminha os resultados da chamada para uma lista de outros ouvintes.

Resumo

Construtores públicos
`ResultForwarder ( listeners)` `ResultForwarder ( listeners)` Crie um `ResultForwarder` .
`ResultForwarder ( ITestInvocationListener... listeners)` Construtor arg de variável alternativa para `ResultForwarder` .

Construtores protegidos
`ResultForwarder ()` Crie um `ResultForwarder` com configuração de ouvinte adiado.

Métodos públicos
`TestSummary`	`getSummary ()` Permite que o InvocationListener retorne um resumo.
`void`	`invocationEnded (long elapsedTime)` Informa que a chamada foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`void`	`invocationFailed ( FailureDescription failure)` Relata uma invocação incompleta 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)` Relata o início da invocação de teste.
`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`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece o log associado ou os dados de depuração da chamada de teste.
`void`	`testModuleEnded ()` Relata o fim de uma execução de 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)` Relata o fim da execução de teste.
`void`	`testRunFailed ( FailureDescription failure)` Falha na execução do teste de relatórios devido a uma falha descrita por `FailureDescription` .
`void`	`testRunFailed (String errorMessage)` Falha na execução do teste de relatórios devido a um erro fatal.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Relata o início de uma execução de teste.
`void`	`testRunStarted (String runName, int testCount)` Relata o início de uma execução de teste.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Relata 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 uma medida precisa .
`void`	`testStarted ( TestDescription test)` Relata o início de um caso de teste individual.

Métodos protegidos
	`getListeners ()` Obtenha a lista de ouvintes.
`void`	`setListeners ( listeners)` `setListeners ( listeners)` Defina os ouvintes após a construção.
`void`	`setListeners ( ITestInvocationListener... listeners)` Defina os ouvintes após a construção.

Construtores públicos

ResultForwarder

public ResultForwarder ( listeners)

Crie um ResultForwarder .

Parâmetros
`listeners`	: o real `ITestInvocationListener` s para encaminhar resultados para

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Construtor arg de variável alternativa para ResultForwarder .

Parâmetros
`listeners`	`ITestInvocationListener` : os `ITestInvocationListener` s reais para encaminhar resultados para

Construtores protegidos

ResultForwarder

protected ResultForwarder ()

Crie um ResultForwarder com configuração de ouvinte adiado. Destinado apenas para uso por subclasses.

Métodos públicos

getResumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Devoluções
`TestSummary`	Um `TestSummary` resumindo a execução, ou nulo

invocaçãoTerminou

public void invocationEnded (long elapsedTime)

Informa que a chamada foi encerrada, seja com sucesso 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ção falhou

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`failure`	`FailureDescription` : a `FailureDescription` descrevendo a causa da falha

invocação falhou

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

public void invocationStarted (IInvocationContext context)

Relata o início da invocação 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

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

testeTerminado

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

testeTerminado

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornece o log associado ou os dados de depuração da chamada de teste.

Deve ser chamado antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long))

A estrutura TradeFederation chamará automaticamente esse método, fornecendo o log do host e, se aplicável, o logcat do dispositivo.

Parâmetros
`dataName`	`String` : um nome descritivo de `String` dos dados. por exemplo, "device_logcat". Observação dataName pode não ser exclusivo por invocação. ou seja, os implementadores devem ser capazes de lidar com várias chamadas com o mesmo dataName
`dataType`	`LogDataType` : o `LogDataType` dos dados
`dataStream`	`InputStreamSource` : o `InputStreamSource` dos dados. Os implementadores devem chamar createInputStream para começar a ler os dados e garantir o fechamento do InputStream resultante quando concluído. Os chamadores devem garantir que a fonte dos dados permaneça presente e acessível até que o método testLog seja concluído.

testModuleEnded

public void testModuleEnded ()

Relata o fim de uma execução de módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Relata o início de um módulo em execução. 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 suíte.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Relata o fim da execução de teste. FIXME: Não podemos ter duas interfaces Map<> com tipo diferente, então temos que usar HashMap aqui.

Parâmetros
`elapsedTime`	`long` : o dispositivo relatou o tempo decorrido, em milissegundos
`runMetrics`	: pares de valores-chave relatados no final de uma execução de teste com `Metric` .

testRunFailed

public void testRunFailed (FailureDescription failure)

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

Parâmetros
`failure`	`FailureDescription` : `FailureDescription` descrevendo a falha e seu contexto.

testRunFailed

public void testRunFailed (String errorMessage)

Falha na execução do teste de relatórios devido a um erro fatal.

Parâmetros
`errorMessage`	`String` : `String` que descreve o motivo da falha de execução.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Relata o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`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 várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Relata o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`int` : número total de testes em execução de teste

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Relata o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução de teste
`testCount`	`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 várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 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()`

testeRunParado

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` : o dispositivo relatou o tempo decorrido, em milissegundos

testeIniciado

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()`

testeIniciado

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

getListeners

protected  getListeners ()

Obtenha a lista de ouvintes. Destinado apenas para uso por subclasses.

Devoluções
	A lista de `ITestInvocationListener` s.

setOuvintes

protected void setListeners ( listeners)

Defina os ouvintes após a construção. Destinado apenas para uso por subclasses.

Parâmetros
`listeners`	: o real `ITestInvocationListener` s para encaminhar resultados para

setOuvintes

protected void setListeners (ITestInvocationListener... listeners)

Defina os ouvintes após a construção. Destinado apenas para uso por subclasses.

Parâmetros
`listeners`	`ITestInvocationListener` : os `ITestInvocationListener` s reais para encaminhar resultados para