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 |
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 |
void
|
processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)
Processamento do proto de registro do caso de teste finalizado após a ocorrência de |
void
|
processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)
Processamento do proto de registro de caso de teste parcial após a ocorrência de |
void
|
processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)
Processamento do proto de registro de módulo finalizado após a ocorrência de |
void
|
processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)
Processamento do proto de registro de módulo parcial após a ocorrência de |
void
|
processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Processamento do proto de registro de execução finalizado após a ocorrência de |
void
|
processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)
Processamento do proto de registro de execução de teste parcial após |
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,
Alternativa a |
void
|
testEnded(TestDescription test,
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,
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 |
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 |
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 |