SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Subclasses diretas conhecidas LegacySubprocessResultsReporter (em inglês) LegacySubprocessResultsReporter Uma implementação congelada do sinalizador de resultados de subprocesso, que precisa permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8 ou mais recente), apesar das mudanças na superclasse.

---

Implementa ITestInvocationListener para ser especificado como um result_reporter e encaminha do subprocesso os resultados de testes, execuções de teste e invocações de teste.

Resumo

Construtores públicos
SubprocessResultsReporter()

Métodos públicos
void	close()
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	invocationStarted(IInvocationContext context) Informa o início da invocação do teste.
void	logAssociation(String dataName, LogFile logFile) Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto.
void	printEvent(String key, Object event) Ajudante para imprimir a chave do evento e o objeto JSON.
void	setOutputTestLog(boolean outputTestLog) Define se vamos ou não gerar a saída do teste registrado.
boolean	supportGranularResults() Retorna "True" se o informante oferece suporte a resultados granulares. Caso contrário, retorna "False".
void	testAssumptionFailure(TestDescription testId, String trace) Chamada quando um teste atômico sinaliza que assume uma condição falsa
void	testAssumptionFailure(TestDescription testId, FailureDescription failure) Chamada quando um teste atômico sinaliza que assume uma condição falsa
void	testEnded(TestDescription testId, long endTime, metrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), em que podemos especificar o horário de término diretamente.
void	testEnded(TestDescription testId, metrics) Informa o término da execução de um caso de teste individual.
void	testFailed(TestDescription testId, FailureDescription failure) Informa a falha de um caso de teste individual.
void	testFailed(TestDescription testId, String reason) Informa a falha de um caso de teste individual.
void	testIgnored(TestDescription testId) É 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 os dados de registro ou depuração associados à invocação do teste.
void	testModuleEnded() Informa o fim da execução de um módulo.
void	testModuleStarted(IInvocationContext moduleContext) Informa o início de um módulo em execução.
void	testRunEnded(long time, 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 reason) 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 arg0) Informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.
void	testSkipped(TestDescription testId, SkipReason reason) É chamado quando um teste é pulado e não é executado por um motivo que não é esperado.
void	testStarted(TestDescription testId, 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 testId) Informa o início de um caso de teste individual.

Construtores públicos

SubprocessResultsReporter

public SubprocessResultsReporter ()

Métodos públicos

fechar

public void close ()

getSummary

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

Será chamado automaticamente pela estrutura da 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 pelo framework 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 uma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Será chamado automaticamente pelo framework TradeFederation. Os repórteres 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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto. Assim, esse callback permite fornecer uma associação forte explicitamente.

Parâmetros
dataName	String: o nome dos dados
logFile	LogFile: o LogFile que foi registrado antes e precisa ser associado ao caso de teste.

printEvent

public void printEvent (String key, 
                Object event)

Ajudante para imprimir a chave do evento e o objeto JSON.

Parâmetros
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Define se devemos ou não gerar o teste registrado.

Parâmetros
outputTestLog	boolean

supportGranularResults

public boolean supportGranularResults ()

Retorna "True" se o informante oferece suporte a resultados granulares. Caso contrário, retorna "False".

Retorna
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Chamada quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
testId	TestDescription: identifica o teste
trace	String: stack trace de falha

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Chamada quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
testId	TestDescription: identifica o teste
failure	FailureDescription: FailureDescription que descreve a falha e o contexto dela.

testEnded

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
testId	TestDescription: identifica o teste.
endTime	long: o horário de término do teste, medido por System.currentTimeMillis().
metrics	: uma ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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 qualquer métrica de chave-valor que possa ter sido emitida durante a execução do caso de teste.

Parâmetros
testId	TestDescription: identifica o teste.
metrics	: uma ERROR(/Map) das métricas emitidas

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
testId	TestDescription: identifica o teste.
failure	FailureDescription: FailureDescription que descreve a falha e o contexto dela.

testFailed

public void testFailed (TestDescription testId, 
                String reason)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
testId	TestDescription: identifica o teste
reason	String: stack trace de falha

testIgnorado

public void testIgnored (TestDescription testId)

Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

Parâmetros
testId	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". 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 terminar. 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 é 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 time, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros
time	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 que descreve a falha e o contexto dela.

testRunFailed

public void testRunFailed (String reason)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

Parâmetros
reason	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 da ordem, identificando as diferentes tentativas do mesmo runName 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 em que a execução começou, medido por System.currentTimeMillis()

testRunStopped

public void testRunStopped (long arg0)

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

TODO: atualmente não usado, considere remover

Parâmetros
arg0	long: tempo decorrido informado pelo dispositivo, em milissegundos

testSkipped

public void testSkipped (TestDescription testId, 
                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
testId	TestDescription: identifica o teste
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription testId, 
                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
testId	TestDescription: identifica o teste
startTime	long: o momento em que o teste começou, medido por System.currentTimeMillis()

testStarted

public void testStarted (TestDescription testId)

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
testId	TestDescription: identifica o teste.