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 apenas que uma lista de permissão de TestDescription seja informada.  JarHostTest.HostTestListener Listener de wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded(), para o listener incorporado.  LogSaverResultForwarder Um ResultForwarder para salvar registros com o salvador de arquivos global.  LogcatCrashResultForwarder Listener especial: em caso de falhas (falha no processo de instrumentação), 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, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector Classe auxiliar para detectar o início e o fim de execuções ausentes.  ModuleResultsAndMetricsForwarder Uma extensão de ResultAndLogForwarder que adiciona métricas extras relacionadas ao módulo aos resultados do teste.  RemoteTestTimeOutEnforcer Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e falhar se ela exceder um determinado tempo limite.  RetryLogSaverResultForwarder Encaminhador que também processa a transmissão da tentativa atual.

---

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

Resumo

Construtores públicos
ResultForwarder(ITestInvocationListener... listeners) Construtor de argumento 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
	getListeners() Receba a lista de listeners.
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 alguma 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 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 pressupõe uma condição falsa.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Chamado quando um teste atômico sinaliza que pressupõe 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 fim da execução de um caso de teste individual.
void	testFailed(TestDescription test, FailureDescription failure) Informa 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 será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Fornece os dados de depuração ou de registro associados 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) O teste de relatórios não foi concluído devido a uma falha descrita por FailureDescription.
void	testRunFailed(String errorMessage) O teste de execução de relatórios não foi concluído 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) O relatório 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 é ignorado e não é executado por um motivo que geralmente 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
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 (ITestInvocationListener... listeners)

Construtor de argumento de variável alternativo para ResultForwarder.

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

ResultForwarder

public ResultForwarder ( listeners)

Crie um ResultForwarder.

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

Construtores protegidos

ResultForwarder

protected ResultForwarder ()

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

Métodos públicos

getListeners

public  getListeners ()

Receba a lista de listeners.

Retorna
	A lista de ITestInvocationListeners.

getSummary

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 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 alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

Informa uma invocação incompleta devido a alguma 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 que uma invocação foi 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 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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

Parâmetros
test	TestDescription: identifica o teste.
trace	String: stack trace da falha

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamado quando um teste atômico sinaliza que pressupõe 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 horário em que o teste terminou, medido por System.currentTimeMillis()
testMetrics	: uma ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna todas 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 que descreve a falha e o contexto dela.

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 da falha

testIgnored

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 os dados de depuração ou de registro associados da invocação de teste.

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

A estrutura TradeFederation chama 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". Observação: dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de 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 fechar o InputStream resultante quando concluído. Os autores da 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 só é usado 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)

O teste de relatórios não foi concluído devido a uma falha descrita por FailureDescription.

Parâmetros
failure	FailureDescription: FailureDescription que descreve a falha e o contexto dela.

testRunFailed

public void testRunFailed (String errorMessage)

O teste de execução de relatórios não foi concluído 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 do pedido, identificando 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 é repetido granularmente três vezes, ele precisa ter quatro execuções no mesmo runName, e o attemptNumber é 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 do pedido, identificando 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 é repetido granularmente três vezes e precisa ter quatro execuções no mesmo runName, e o attemptNumber é de 0 a 3.
startTime	long: o horário em que a execução começou, medido por System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

O relatório informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.

TODO: currently unused, consider removing

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 geralmente não é esperado. Esses testes serão repetidos 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 medição precisa.

Parâmetros
test	TestDescription: identifica o teste.
startTime	long: o horário 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

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 encaminhar os 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 encaminhar os resultados.