ProtoResultReporter

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

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

O Result Reporter cria um protobuf TestRecord com todos os resultados. Precisa ser estendida para processar 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 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 uma 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 pulada

final void invocationStarted(IInvocationContext context)

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

final void logAssociation(String dataName, LogFile logFile)

Em alguns casos, o registro precisa ser 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 processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)

Use o registro de invocação para enviar um por um todos os registros finais da invocação.

void processFinalProto(TestRecordProto.TestRecord finalRecord)

Processamento do protótipo final com todos os resultados.

void processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Processamento do proto de registro de teste de invocação parcial após a ocorrência de invocationStarted(com.android.tradefed.invoker.IInvocationContext).

void processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)

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

void processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)

Processamento do proto de registro de caso de teste parcial após a ocorrência de testStarted(com.android.tradefed.result.TestDescription, long).

void processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)

Processamento do proto de registro de módulo finalizado após a ocorrência de testModuleEnded().

void processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)

Processamento do proto 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)

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

void processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)

Processamento do proto de registro de execução de teste parcial após testRunStarted(String, int) ocorrer.

void setGranularResults(boolean granularResults)
void setInlineRecordOfChildren(boolean inline)
boolean supportGranularResults()

Retorna "True" se o informante for compatível com resultados granulares. Caso contrário, retorna "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)

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

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

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 é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

final void testModuleEnded()

Informa o fim da execução de um módulo.

final void testModuleStarted(IInvocationContext moduleContext)

Informa o início da execução de um módulo.

final void testRunEnded(long elapsedTimeMillis, runMetrics)

Informa o fim da execução do teste.

final void testRunFailed(FailureDescription failure)

A execução do teste não foi concluída devido a uma falha descrita por FailureDescription.

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

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

final void testSkipped(TestDescription test, SkipReason reason)

É chamado quando um teste é pulado e não é executado por um motivo que não é esperado.

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

final void testStarted(TestDescription test)

Informa o início de um caso de teste individual.

Métodos protegidos

void afterModuleEnd()
void beforeModuleStart()
TestRecordProto.ChildReference createModuleChildReference(TestRecordProto.TestRecord record)

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

Construtores públicos

ProtoResultReporter

public ProtoResultReporter ()

Métodos públicos

invocationEnded

public final 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 pelo framework 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 uma condição de erro.

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
cause Throwable: a causa Throwable da falha

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi pulada

Parâmetros
reason SkipReason

invocationStarted

public final 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 a vários dispositivos.

Parâmetros
context IInvocationContext: informações sobre a invocação

associação de registro

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Use o registro de invocação para enviar um por um todos os registros finais da invocação.

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

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Processamento do protótipo final com todos os resultados.

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

processStartInvocation

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

Processamento do proto de registro de teste de invocação parcial após a ocorrência de invocationStarted(com.android.tradefed.invoker.IInvocationContext).

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

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Processamento do registro de caso de teste finalizado proto após ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

Parâmetros
testCaseRecord TestRecordProto.TestRecord: o proto finalizado que representa um caso de teste.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Processamento do proto de registro de caso de teste parcial após a ocorrência de testStarted(com.android.tradefed.result.TestDescription, long).

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

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Processamento do proto de registro de 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)

Processamento do proto 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)

Processamento do proto 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á em andamento ou não.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Processamento do proto de registro de execução de teste parcial após testRunStarted(String, int) ocorrer.

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 informante oferece suporte a resultados granulares. Caso contrário, retorna "False".

Retorna
boolean

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Chamada 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 final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamada 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 final 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 tempo em que o teste foi concluído, medido por System.currentTimeMillis()
testMetrics : uma ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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 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 final 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 final 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 de falha

testIgnored

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

testModuleEnded

public final void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public final 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. Ele é usado apenas durante uma execução que usa módulos: executores baseados em pacote.

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros
elapsedTimeMillis long: tempo decorrido informado pelo dispositivo, em milissegundos
runMetrics : pares de chave-valor informados no final de uma execução de teste

testRunFailed

public final 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 final 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 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 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 final 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 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 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 de início da corrida, medida usando System.currentTimeMillis().

testSkipped

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

testStarted

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

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

testStarted

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

afterModuleEnd

protected void afterModuleEnd ()

antesModuleStart

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

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

Parâmetros
record TestRecordProto.TestRecord

Retorna
TestRecordProto.ChildReference