SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

Implementa ITestInvocationListener para ser especificado como 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)

Relata que a invocação foi encerrada, seja com êxito 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 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)

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

void setOutputTestLog (boolean outputTestLog)

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

boolean supportGranularResults ()

Retorna True se o relator oferecer suporte a resultados granulares; caso contrário, retorna 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)

Relata o final 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 log associado ou dados de depuração da invocação de teste.

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

Relata o início de um módulo em execução.

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

Informa o final da execução do teste.

void testRunFailed ( FailureDescription failure)

A execução do teste de relatórios 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)

A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.

void testSkipped ( TestDescription testId, SkipReason reason)

Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado.

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 uma medida 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 ()

obter Resumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

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

invocaçãoEnded

public void invocationEnded (long elapsedTime)

Relata que a invocação foi encerrada, seja com êxito 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çãoFailed

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 que descreve a causa da falha

invocaçãoFailed

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 void invocationStarted (IInvocationContext context)

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

logAssociação

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, este retorno de chamada permite fornecer explicitamente uma associação forte.

Parâmetros
dataName String : O nome dos dados

logFile LogFile : o LogFile que foi logado anteriormente e deve ser associado ao caso de teste.

imprimirEvento

public void printEvent (String key, 
                Object event)

Auxiliar 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 gerar o teste registrado ou não.

Parâmetros
outputTestLog boolean

suporteGranularResults

public boolean supportGranularResults ()

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

Devoluções
boolean

testeAssunçãoFalha

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

testeAssunçãoFalha

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 que descreve a falha e seu contexto.

teste finalizado

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 : o horário em que o teste terminou, medido via System.currentTimeMillis()

metrics : um ERROR(/Map) das métricas emitidas

teste finalizado

public void testEnded (TestDescription testId, 
                 metrics)

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
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 que descreve 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

testeLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornece o log associado ou dados de depuração da invocação 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 da String dos dados. por exemplo, "dispositivo_logcat". Nota 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)

Relata o início de um módulo em execução. Este 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 void testRunEnded (long time, 
                 runMetrics)

Informa o final 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 de valores-chave 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 não foi concluída devido a uma falha descrita por FailureDescription .

Parâmetros
failure FailureDescription : FailureDescription que descreve 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 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 diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontecer. por exemplo, um teste é repetido de forma granular 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 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)

Informa 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 diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontecer. por exemplo, um teste é repetido de forma granular 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

teste ignorado

public void testSkipped (TestDescription testId, 
                SkipReason reason)

Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. Esses testes serão tentados novamente para tentar obter uma execução adequada.

Parâmetros
testId TestDescription : identifica o teste

reason SkipReason : SkipReason

teste iniciado

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

Parâmetros
testId TestDescription : identifica o teste

startTime long : a hora em que o teste começou, medido via System.currentTimeMillis()

teste iniciado

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