ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

Subclasses diretas conhecidas FileProtoResultReporter , StreamProtoResultReporter FileProtoResultReporter Repórter proto que despeja o TestRecord em um arquivo. StreamProtoResultReporter Uma implementação do ProtoResultReporter

---

O repórter de resultados constrói um protobuf TestRecord com todos os resultados dentro. Deve ser estendido para lidar com o que fazer com o proto final em processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

Resumo

Construtores públicos
ProtoResultReporter ()

Métodos públicos
final void	invocationEnded (long elapsedTime) Informa que a chamada foi encerrada, 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.
final void	invocationStarted ( IInvocationContext context) Relata o início da invocação de teste.
final void	logAssociation (String dataName, LogFile logFile) Em alguns casos, o log deve estar fortemente associado a um caso de teste, mas a oportunidade de fazê-lo diretamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.
void	processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Use o registro de invocação para enviar um a um todos os logs finais da invocação.
void	processFinalProto (TestRecordProto.TestRecord finalRecord) Manipulação do proto final com todos os resultados.
void	processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Manipulação do protocolo de registro de teste de invocação parcial após invocationStarted(com.android.tradefed.invoker.IInvocationContext) ocorrer.
void	processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Manipulação do protocolo de registro de caso de teste finalizado após a ocorrência de ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .
void	processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Manipulação do proto de registro de caso de teste parcial após testStarted(com.android.tradefed.result.TestDescription, long) ocorrer.
void	processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Manipulação do protocolo de registro do módulo finalizado após a ocorrência de testModuleEnded() .
void	processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Manipulação do protocolo de registro de módulo parcial após a ocorrência de testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .
void	processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Manipulação do protocolo de registro de execução finalizado após a ocorrência de ERROR(/#testRunEnded(long,HashMap)) .
void	processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Manipulação do protocolo de registro de execução de teste parcial após a ocorrência de testRunStarted(String, int) .
void	setGranularResults (boolean granularResults)
void	setInlineRecordOfChildren (boolean inline)
boolean	supportGranularResults () Retorna True se o relator oferecer suporte a resultados granulares, caso contrário, false.
final void	testAssumptionFailure ( TestDescription test, String trace) Chamado quando um teste atômico sinaliza que assume uma condição falsa
final void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Chamado quando um teste atômico sinaliza que assume uma condição falsa
final void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Relata o final da execução de um caso de teste individual.
final void	testFailed ( TestDescription test, FailureDescription failure) Relata a falha de um caso de teste individual.
final void	testFailed ( TestDescription test, String trace) Relata a falha de um caso de teste individual.
final void	testIgnored ( TestDescription test) Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
final void	testModuleEnded () Relata o fim de uma execução de módulo.
final void	testModuleStarted ( IInvocationContext moduleContext) Relata o início de um módulo em execução.
final void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Relata o fim da execução de teste.
final void	testRunFailed ( FailureDescription failure) Falha na execução do teste de relatórios devido a uma falha descrita por FailureDescription .
final void	testRunFailed (String errorMessage) Falha na execução do teste de relatórios devido a um erro fatal.
void	testRunStarted (String runName, int testCount, int attemptNumber) Relata o início de uma execução de teste.
final void	testRunStarted (String runName, int testCount) Relata o início de uma execução de teste.
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Relata o início de uma execução de teste.
final void	testStarted ( TestDescription test, 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 uma medida precisa .
final void	testStarted ( TestDescription test) Relata o início de um caso de teste individual.

Métodos protegidos
TestRecordProto.ChildReference	createModuleChildReference (TestRecordProto.TestRecord record) Cria uma referência filho para um módulo.

Construtores públicos

ProtoResultReporter

public ProtoResultReporter ()

Métodos públicos

invocaçãoTerminou

public final void invocationEnded (long elapsedTime)

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

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

Parâmetros
failure	FailureDescription : a FailureDescription descrevendo 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 pelo framework TradeFederation.

Parâmetros
cause	Throwable : a causa Throwable da falha

invocaçãoIniciada

public final void invocationStarted (IInvocationContext context)

Relata o início da invocação de teste.

Será chamado automaticamente pelo framework 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 final void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o log deve estar fortemente associado a um caso de teste, mas a oportunidade de fazê-lo diretamente 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 uma associação forte explicitamente.

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Use o registro de invocação para enviar um a um todos os logs finais da invocação.

Parâmetros
invocationLogs	TestRecordProto.TestRecord : O proto finalizado que representa a invocação.

processoFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Manipulação do proto final com todos os resultados.

Parâmetros
finalRecord	TestRecordProto.TestRecord : O proto finalizado com todos os resultados da invocação.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Manipulação do protocolo de registro de teste de invocação parcial após invocationStarted(com.android.tradefed.invoker.IInvocationContext) ocorrer.

Parâmetros
invocationStartRecord	TestRecordProto.TestRecord : O proto parcial preenchido após o invocationStart.
invocationContext	IInvocationContext : A invocação IInvocationContext .

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Manipulação do protocolo de registro de caso de teste finalizado após a ocorrência de ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Parâmetros
testCaseRecord	TestRecordProto.TestRecord : O proto finalizado representando um caso de teste.

processoTestCaseIniciado

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Manipulação do proto de registro de caso de teste parcial após testStarted(com.android.tradefed.result.TestDescription, long) ocorrer.

Parâmetros
testCaseStartedRecord	TestRecordProto.TestRecord : O proto parcial que representa o caso de teste.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Manipulação do protocolo de registro do módulo finalizado após a ocorrência de testModuleEnded() .

Parâmetros
moduleRecord	TestRecordProto.TestRecord : O proto finalizado que representa o módulo.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Manipulação do protocolo de registro de módulo parcial após a ocorrência de testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Parâmetros
moduleStartRecord	TestRecordProto.TestRecord : O proto parcial que representa o módulo.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Manipulação do protocolo de registro de execução finalizado após a ocorrência de ERROR(/#testRunEnded(long,HashMap)) .

Parâmetros
runRecord	TestRecordProto.TestRecord : O proto finalizado que representa a execução.
moduleInProgress	boolean : se um módulo está ou não em andamento.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Manipulação do protocolo de registro de execução de teste parcial após a ocorrência de testRunStarted(String, int) .

Parâmetros
runStartedRecord	TestRecordProto.TestRecord : O proto parcial que representa a execução.

setGranularResults

public void setGranularResults (boolean granularResults)

Parâmetros
granularResults	boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parâmetros
inline	boolean

supportGranularResults

public boolean supportGranularResults ()

Retorna True se o relator oferecer suporte a resultados granulares, caso contrário, false.

Devoluções
boolean

testeAssunçãoFalha

public final 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 : rastreamento de pilha de falha

testeAssunçãoFalha

public final 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 seu contexto.

testeTerminado

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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 medição precisa.

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

testeTerminado

public void testEnded (TestDescription test, 
                 testMetrics)

Relata o final da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi invocado, este 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
test	TestDescription : identifica o teste
testMetrics	: um ERROR(/Map) das métricas emitidas

teste falhou

public final 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 seu contexto.

teste falhou

public final 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 : rastreamento de pilha de falha

testeIgnorado

public final 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

testModuleEnded

public final void testModuleEnded ()

Relata o fim de uma execução de módulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Relata o início de um módulo em execução. 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 suíte.

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Relata o fim da execução de teste. FIXME: Não podemos ter duas interfaces Map<> com tipo diferente, então temos que usar HashMap aqui.

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

Falha na execução do teste de relatórios devido a um erro fatal.

Parâmetros
errorMessage	String : String que descreve o motivo da falha de execução.

testRunStarted

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

Relata 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 em execução de teste
attemptNumber	int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Relata 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 em execução de teste

testRunStarted

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

Relata 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 em execução de teste
attemptNumber	int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 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()

testeIniciado

public final void testStarted (TestDescription test, 
                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 uma medida precisa .

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

testeIniciado

public final void testStarted (TestDescription test)

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

Métodos protegidos

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Cria uma referência filho para um módulo.

Parâmetros
record	TestRecordProto.TestRecord

Devoluções
TestRecordProto.ChildReference