SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Implementa ITestInvocationListener a ser especificado como um result_reporter e encaminhado de o subprocesso, os resultados de 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 invocação foi encerrada, seja com sucesso ou devido a algum erro condição.

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

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile logFile)

Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível.

void printEvent(String key, Object event)

Auxiliar para imprimir a chave de evento e o objeto json.

void setOutputTestLog(boolean outputTestLog)

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

boolean supportGranularResults()

Retorna "True" se o informante for compatível com 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)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), em que podemos especificar o horário de término diretamente.

void testEnded(TestDescription testId, metrics)

Informa 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 é 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 os dados de depuração da invocação de teste.

void testModuleEnded()

Informa o final de uma execução de módulo.

void testModuleStarted(IInvocationContext moduleContext)

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

void testRunEnded(long time, runMetrics)

Informa o fim 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 executado por um motivo que normalmente não é esperado.

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

void testStarted(TestDescription testId)

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

Construtores públicos

SubprocessResultsReporter

public SubprocessResultsReporter ()

Métodos públicos

fechar

public void close ()

getResumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Retorna
TestSummary Um TestSummary que resume a execução ou é nulo.

invocaçãoFinalizada

public void invocationEnded (long elapsedTime)

Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
elapsedTime long: o tempo decorrido da invocação em ms

InvocationFalha

public void invocationFailed (FailureDescription failure)

Informa uma invocação incompleta devido a uma condição de erro.

Será chamado automaticamente pela estrutura 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 uma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
cause Throwable: a causa Throwable da falha.

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Será chamado automaticamente pela estrutura TradeFederation. Os informantes precisam substituir esse método para oferecer suporte à geração de relatórios de vários dispositivos.

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

associação de registro

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível. 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.

printEvent

public void printEvent (String key, 
                Object event)

Auxiliar para imprimir a chave de evento e 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.

Parâmetros
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

Retorna "True" se o informante for compatível com resultados granulares. Caso contrário, retorna "false".

Retorna
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: stack trace 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 o contexto.

testEnded

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

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
testId TestDescription: identifica o teste.
endTime long: o horário de término do teste, medido por System.currentTimeMillis().
metrics : um ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna qualquer chave/valor métricas que podem 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

testFailed

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 o contexto.

testFailed

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: stack trace de falha

testIgnorado

public void testIgnored (TestDescription testId)

Chamado quando um teste não é 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 os dados de depuração da invocação de teste.

Precisa ser chamado antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long))

A estrutura da TradeFederation chamará automaticamente esse método, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

Parâmetros
dataName String: um nome descritivo de String dos dados. Por exemplo: "device_logcat". Observação dataName pode não ser exclusivo por invocação. os implementadores devem ser capazes de lidar 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 começar a ler os dados e fechar o InputStream quando concluído. Os autores da chamada precisam garantir que a fonte dos dados não seja alterada. presente e acessível até que o método testLog seja concluído.

testModuleEnded

public void testModuleEnded ()

Informa o final de uma execução de módulo.

testModuleStarted

public 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. Ela só é usada durante uma execução que usa módulos: executores baseados em pacote.

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 dois Map<> interfaces com tipos diferentes, então precisamos usar o HashMap aqui.

Parâmetros
time long: tempo decorrido informado pelo dispositivo, em milissegundos.
runMetrics : pares de chave-valor informados no final de um 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 descrevendo a falha e o 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 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 de 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 executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado todas as vezes ocorre uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro no total é executado com o mesmo runName, e o tryNumber varia 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 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 de 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 executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado sempre que um uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro execuções no total com o mesmo runName, e o tryNumber vai de 0 a 3.
startTime long: o horário de início da corrida, medida usando System.currentTimeMillis().

testRunSStop

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: não usado no momento, considere remover

Parâmetros
arg0 long: tempo decorrido informado pelo dispositivo, em milissegundos.

testSkipped

public void testSkipped (TestDescription testId, 
                SkipReason reason)

Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. Tentaremos realizar esses testes novamente para tentar obter uma execução adequada.

Parâmetros
testId TestDescription: identifica o teste.
reason SkipReason: SkipReason

testStarted

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

Parâmetros
testId TestDescription: identifica o teste.
startTime long: o horário de início do teste, medido por System.currentTimeMillis().

testStarted

public void testStarted (TestDescription testId)

Informa o início de um caso de teste individual. A interface mais antiga precisa usar testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

Parâmetros
testId TestDescription: identifica o teste.