O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Encaminhador de resultados

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 apenas que uma lista de permissões de `TestDescription` seja informada.
JarHostTest.HostTestListener (link em inglês)	Listener de wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded() para o listener incorporado.
LogSaverResultForwarder	Um `ResultForwarder` para salvar registros com o protetor de arquivos global.
LogcatCrashResultForwarder	Listener especial: em falhas (processo de instrumentação com falha), ele tenta extrair do logcat a falha e a adiciona à mensagem de falha associada ao teste.
PythonBinaryHostTest.PythonForwarder	Encaminhador de resultados para substituir o nome da execução pelo nome binário.
ResultAndLogForwarder	Encaminhador de resultados e eventos de registro.
RetryResultForwarder.	Uma extensão de `ResultForwarder` que sempre envia para um determinado número de tentativas.
ShardMainResultForwarder	Um `ResultForwarder` que combina os resultados de invocações de teste fragmentadas.
TestTimeoutEnforcer	Listeners que permitem verificar o tempo de execução de um determinado caso de teste e falhar se ele exceder um determinado tempo limite.

Subclasses indiretas conhecidas

GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Assistente de classe para detectar o início e o fim da execução ausentes.
RetryLogSaverResultForwarder.	Encaminhador que também lida com a transmissão da tentativa atual.

Um ITestInvocationListener que encaminha os resultados de invocação para uma lista de outros listeners.

Resumo

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

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

Métodos públicos
`TestSummary`	`getSummary()` Permite que o InvocationListener retorne um resumo.
`void`	`invocationEnded(long elapsedTime)` Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`void`	`invocationFailed(FailureDescription failure)` Informa uma invocação incompleta devido a uma condição de erro.
`void`	`invocationFailed(Throwable cause)` Informa uma invocação incompleta devido a alguma condição de erro.
`void`	`invocationSkipped(SkipReason reason)` Informa que uma invocação foi pulada
`void`	`invocationStarted(IInvocationContext context)` Informa o início da invocação do teste.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Chamada quando um teste atômico sinaliza que assume uma condição falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chamada 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 término 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)` Informa 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`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece o registro associado ou os dados de depuração da invocação de teste.
`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)` Informa o fim da execução do teste.
`void`	`testRunFailed(FailureDescription failure)` A execução do teste 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 runName, int testCount, int attemptNumber)` Informa o início de uma execução de teste.
`void`	`testRunStarted(String runName, int testCount)` Informa o início de uma execução de teste.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa o início de uma execução de teste.
`void`	`testRunStopped(long elapsedTime)` Informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.
`void`	`testSkipped(TestDescription test, SkipReason reason)` É chamado quando um teste é pulado e não é executado por um motivo que 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 medida precisa.
`void`	`testStarted(TestDescription test)` Informa o início de um caso de teste individual.

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

Construtores públicos

Encaminhador de resultados

public ResultForwarder (ITestInvocationListener... listeners)

Construtor de variável alternativo para ResultForwarder.

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

Encaminhador de resultados

public ResultForwarder ( listeners)

Crie um ResultForwarder.

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

Construtores protegidos

Encaminhador de resultados

protected ResultForwarder ()

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

Métodos públicos

getResumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Retorna
`TestSummary`	Um `TestSummary` que resume a execução ou nulo

invocationEnded

public void invocationEnded (long elapsedTime)

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

Será chamado automaticamente pela estrutura da TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
`failure`	`FailureDescription`: o `FailureDescription` que descreve a causa da falha

InvocationFalha

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pela estrutura da TradeFederation.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi pulada

Parâmetros
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Será chamado automaticamente pela estrutura da TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a vários dispositivos.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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 tempo em que o teste foi concluído, medido por `System.currentTimeMillis()`
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Informa o término da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna as métricas de chave/valor que podem ter sido emitidas durante a execução do caso de teste.

Parâmetros
`test`	`TestDescription`: identifica o teste
`testMetrics`	: uma `ERROR(/Map)` das métricas emitidas

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

Informa 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

testIgnored

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

testLog

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

Fornece os dados de registro ou depuração associados à invocação do teste.

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

O framework TradeFederation vai chamar esse método automaticamente, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

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

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 callback está associado a testModuleEnded() e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em pacotes.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	: pares de chave-valor informados no final de uma execução de teste

testRunFailed

public void testRunFailed (FailureDescription failure)

A execução do teste 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 runName, 
                int testCount, 
                int attemptNumber)

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

Parâmetros
`runName`	`String`: o nome da execução do teste
`testCount`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado três vezes, então precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStarted

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

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

Parâmetros
`runName`	`String`: o nome da execução do teste
`testCount`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado granularmente três vezes, ele precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.
`startTime`	`long`: o horário de início da corrida, medida usando `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 usado, 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 é pulado e não é executado por um motivo que não é esperado. Esses testes serão tentados novamente para tentar 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 medida precisa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`startTime`	`long`: o momento em que o teste começou, medido por `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. Interface mais antiga, use testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

Parâmetros
`test`	`TestDescription`: identifica o teste

Métodos protegidos

getListeners

protected  getListeners ()

Receba a lista de listeners. Destinado apenas ao uso por subclasses.

Retorna
	A lista de `ITestInvocationListener`s.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

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

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

setListeners

protected void setListeners ( listeners)

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

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