SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

Subclasses diretas conhecidas LegacySubprocessResultsReporter LegacySubprocessResultsReporter Uma implementação congelada do subprocess results reporter que deve permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8+), apesar das mudanças em sua superclasse.

---

Implementa ITestInvocationListener para ser especificado como um result_reporter e encaminhar do subprocesso os resultados dos testes, execuções de teste, 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 chamada foi finalizada, 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) Informa o início da chamada de teste.
void	logAssociation (String dataName, LogFile logFile) Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.
void	printEvent (String key, Object event) Helper para imprimir a chave do evento e depois o objeto json.
void	setOutputTestLog (boolean outputTestLog) Define se devemos ou não enviar o teste logado ou não.
boolean	supportGranularResults () Retorna True se o relator suportar resultados granulares, caso contrário, false.
void	testAssumptionFailure ( TestDescription testId, String trace) Chamado quando um teste atômico sinaliza que assume uma condição falsa
void	testAssumptionFailure ( TestDescription testId, FailureDescription failure) Chamado quando um teste atômico sinaliza que assume uma condição falsa
void	testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente.
void	testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Informa o fim da execução de um caso de teste individual.
void	testFailed ( TestDescription testId, FailureDescription failure) Relata a falha de um caso de teste individual.
void	testFailed ( TestDescription testId, String reason) Relata a falha de um caso de teste individual.
void	testIgnored ( TestDescription testId) 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 registro associado ou dados de depuração da chamada 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 time, runMetrics) testRunEnded (long time, runMetrics) Informa o fim da execução do teste.
void	testRunFailed ( FailureDescription failure) A execução do teste de relatórios falhou 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) 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 testId, 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 medição precisa .
void	testStarted ( TestDescription testId) Relata 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.

devoluções
TestSummary	Um TestSummary resumindo a execução ou nulo

invocaçãoEncerrada

public void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, 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

invocação falhou

public void invocationFailed (FailureDescription failure)

Relata 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

invocação falhou

public void invocationFailed (Throwable cause)

Relata 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

invocaçãoIniciado

public void invocationStarted (IInvocationContext context)

Informa o início da chamada de 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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, esse retorno de chamada permite fornecer explicitamente uma forte associação.

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

printEvent

public void printEvent (String key, 
                Object event)

Helper para imprimir a chave do evento e depois o objeto json.

Parâmetros
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Define se devemos ou não enviar o teste logado ou não.

Parâmetros
outputTestLog	boolean

supportGranularResults

public boolean supportGranularResults ()

Retorna True se o relator suportar resultados granulares, caso contrário, false.

devoluções
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

Parâmetros
testId	TestDescription : identifica o teste
failure	FailureDescription : FailureDescription descrevendo a falha e seu contexto.

testeFinalizado

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

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 medida precisa.

Parâmetros
testId	TestDescription : identifica o teste
endTime	long : a hora em que o teste terminou, medido via System.currentTimeMillis()
metrics	: um ERROR(/Map) das métricas emitidas

testeFinalizado

public void testEnded (TestDescription testId, 
                 metrics)

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

Se testFailed(TestDescription, FailureDescription) não foi chamado, esse 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
testId	TestDescription : identifica o teste
metrics	: um ERROR(/Map) das métricas emitidas

teste falhou

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
testId	TestDescription : identifica o teste
failure	FailureDescription : FailureDescription descrevendo a falha e seu contexto.

teste falhou

public void testFailed (TestDescription testId, 
                String reason)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
testId	TestDescription : identifica o teste
reason	String : rastreamento de pilha de falha

testeIgnorado

public void testIgnored (TestDescription testId)

Chamado quando um teste não será 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 o registro associado ou 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 String dos dados. por exemplo, "dispositivo_logcat". Observação dataName pode não ser exclusivo por chamada. 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 iniciar a leitura dos 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 ()

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 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 suite.

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

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Informa o fim da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então temos que usar HashMap aqui.

Parâmetros
time	long : tempo decorrido relatado pelo dispositivo, em milissegundos
runMetrics	: pares chave-valor relatados no final de uma execução de teste com Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

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 que descreve 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 executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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)

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 executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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()

testRunStopped

public void testRunStopped (long arg0)

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
arg0	long : tempo decorrido relatado pelo dispositivo, em milissegundos

testStarted

public void testStarted (TestDescription testId, 
                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 medição precisa .

Parâmetros
testId	TestDescription : identifica o teste
startTime	long : a hora em que o teste começou, medido via System.currentTimeMillis()

testStarted

public void testStarted (TestDescription testId)

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