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, TestTimeoutr. FilteredResultForwarder. Variante de ResultForwarder que permite que apenas uma lista de permissões do TestDescription seja relatadas.  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 (falha no processo de instrumentação), ele tentará extrair do ao logcat da falha e o adiciona à mensagem de falha associada ao teste.  PythonBinaryHostTest.PythonForwarder (link em inglês) Encaminhador de resultados para substituir o nome da execução pelo nome binário.  ResultAndLogForwarder (link em inglês) Encaminhador para resultados e eventos de registros.  RetryResultForwarder. Uma extensão de ResultForwarder que sempre envia para um determinado número de tentativa.  ShardMainResultForwarder (link em inglês) Um ResultForwarder que combina os resultados de invocações de teste fragmentadas.  TestTimeoutEnforcer (em inglês) Listeners que permitem verificar o tempo de execução de um determinado caso de teste e falhar se ocorrer durante um determinado tempo limite.

Subclasses indiretas conhecidas GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector (link em inglês) Assistente de classe para detectar o início e o fim da execução ausentes.  RetryLogSaverResultForwarder. Encaminhador que também processa a tentativa atual em que estamos.

---

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

Resumo

Construtores públicos
ResultForwarder( listeners) Crie um ResultForwarder.
ResultForwarder(ITestInvocationListener... listeners) Construtor de argumento de variável alternativa para 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 algum erro condição.
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 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.
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	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 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 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) 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
	getListeners() Consulte 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

ResultForwarder.

public ResultForwarder ( listeners)

Crie um ResultForwarder.

Parâmetros
listeners	: os ITestInvocationListeners reais para os quais encaminhar resultados.

ResultForwarder.

public ResultForwarder (ITestInvocationListener... listeners)

Construtor de argumento de variável alternativa para ResultForwarder.

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

Construtores protegidos

ResultForwarder.

protected ResultForwarder ()

Crie um ResultForwarder com a configuração de listener adiado. Destinado somente ao 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.

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

InvocationFalha

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pela estrutura 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 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.

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.

testLog

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

Fornece o registro associado ou os dados de depuração da invocação de teste.

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

A estrutura da TradeFederation chamará automaticamente esse método, fornecendo o registro 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. os implementadores devem ser capazes de lidar 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 fechar o InputStream quando concluído. Os autores da chamada precisam garantir que a fonte dos dados não seja alterada. presente e acessível até que o método testLog seja concluído.

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 runName, 
                int testCount, 
                int attemptNumber)

Informa 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 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 runName, 
                int testCount)

Informa 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 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 de teste.
testCount	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().

testRunSStop

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

getListeners

protected  getListeners ()

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

Retorna
	Lista de ITestInvocationListeners.

setListeners.

protected void setListeners (ITestInvocationListener... listeners)

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

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

setListeners.

protected void setListeners ( listeners)

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

Parâmetros
listeners	: os ITestInvocationListeners reais para os quais encaminhar resultados.