ResultReporter

public class ResultReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
   ↳ com.google.android.tradefed.result.teststorage.ResultReporter

Resumo

Classes aninhadas

class ResultReporter.ListBuilder<T>

 

Constantes

String DEFAULT_BUILDPROVIDER

String EXPERIMENTAL

String SYSTEM_CHECKER

String TRADEFED

Construtores públicos

ResultReporter()

Métodos públicos

void enableFilterProperty(boolean enableFilterProperty)
IConfiguration getConfiguration()
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 alguma condição de erro.

void invocationFailed(FailureDescription failure)

Informa uma invocação incompleta devido a alguma 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 ignorada

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile log)

Em alguns casos, o registro precisa estar fortemente associado a um caso de teste, mas não é possível fazer isso no callback direto do testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

void putEarlySummary( summaries)

Transmite um ERROR(/List) de TestSummarys não nulos que podem ter sido retornados de qualquer ITestInvocationListeners instanciado como parte da configuração.

void setConfiguration(IConfiguration configuration)

Injeta o IConfiguration em uso.

void setLogSaver(ILogSaver logSaver)

Defina ILogSaver para permitir que o implementador salve arquivos.

boolean supportGranularResults()

Retorna "True" se o criador de relatórios oferecer suporte a resultados detalhados. Caso contrário, retorna "False".

void testAssumptionFailure(TestDescription test, String trace)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

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, metrics)

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

void testFailed(TestDescription test, FailureDescription failure)

Informa a falha de um caso de teste individual.

void testFailed(TestDescription test, String trace)

Informa a falha de um caso de teste individual.

void testIgnored(TestDescription test)

Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

void testModuleEnded()

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

void testModuleStarted(IInvocationContext moduleContext)

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

void testRunEnded(long elapsedTimeMillis, runMetrics)

Informa o fim da execução do teste.

void testRunFailed(FailureDescription failure)

O teste de relatórios não foi concluído devido a uma falha descrita por FailureDescription.

void testRunFailed(String errorMessage)

O teste de execução de relatórios não foi concluído 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 testSkipped(TestDescription test, SkipReason reason)

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

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

void testStarted(TestDescription test)

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

Métodos protegidos

ITestStorageClient createTestStorageClient(IInvocationContext context)
String getVersion()

Constantes

DEFAULT_BUILDPROVIDER

public static final String DEFAULT_BUILDPROVIDER

Valor da constante: "androidbuild"

EXPERIMENTAL

public static final String EXPERIMENTAL

Valor da constante: "experimental"

SYSTEM_CHECKER

public static final String SYSTEM_CHECKER

Valor da constante: "system_checker"

TRADEFED

public static final String TRADEFED

Valor da constante: "tradefed"

Construtores públicos

ResultReporter

public ResultReporter ()

Métodos públicos

enableFilterProperty

public void enableFilterProperty (boolean enableFilterProperty)

Parâmetros
enableFilterProperty boolean

getConfiguration

public IConfiguration getConfiguration ()

Retorna
IConfiguration

getSummary

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

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

invocationEnded

public 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 pela estrutura 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 alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
failure FailureDescription: o FailureDescription que descreve a causa da falha

invocationFailed

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
cause Throwable: a causa Throwable da falha

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi ignorada

Parâmetros
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Será chamado automaticamente pela estrutura 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 void logAssociation (String dataName, 
                LogFile log)

Em alguns casos, o registro precisa estar fortemente associado a um caso de teste, mas não é possível fazer isso no callback direto do testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Assim, esse callback permite fornecer uma associação forte de forma explícita.

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

putEarlySummary

public void putEarlySummary ( summaries)

Transmite um ERROR(/List) de TestSummarys não nulos que podem ter sido retornados de qualquer ITestInvocationListeners instanciados como parte da configuração. Os resumos iniciais são gerados após ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) e podem ser concluídos no final da invocação via ERROR(/#putSummary(List)).

Isso é chamado antes de ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) e contém todos os resumos dos listeners configurados antes dele.

Parâmetros
summaries : uma ERROR(/List) de TestSummarys não nulos de ITestInvocationListeners que fazem parte da configuração atual.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
configuration IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Defina ILogSaver para permitir que o implementador salve arquivos.

Parâmetros
logSaver ILogSaver: o ILogSaver

supportGranularResults

public boolean supportGranularResults ()

Retorna "True" se o criador de relatórios oferecer suporte a resultados detalhados. Caso contrário, retorna "False".

Retorna
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

Parâmetros
test TestDescription: identifica o teste.
trace String: stack trace da falha

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.

Parâmetros
test TestDescription: identifica o teste.
failure FailureDescription: FailureDescription que descreve a falha e o contexto dela.

testEnded

public 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 horário em que o teste terminou, medido por System.currentTimeMillis()
testMetrics : uma ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 metrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna todas 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.
metrics : uma ERROR(/Map) das métricas emitidas

testFailed

public 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 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 da falha

testIgnored

public 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 void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa o início da execução de um módulo. Esse callback está associado a testModuleEnded() e é opcional na sequência. Ele só é usado durante uma execução que usa módulos: executores baseados em pacotes.

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

testRunEnded

public 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 void testRunFailed (FailureDescription failure)

O teste de relatórios não foi concluído devido a uma falha descrita por FailureDescription.

Parâmetros
failure FailureDescription: FailureDescription que descreve a falha e o contexto dela.

testRunFailed

public void testRunFailed (String errorMessage)

O teste de execução de relatórios não foi concluído 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 do pedido, identificando 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 é repetido granularmente três vezes, ele precisa ter quatro execuções no mesmo runName, e o attemptNumber é 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 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 do pedido, identificando 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 é repetido granularmente três vezes e precisa ter quatro execuções no mesmo runName, e o attemptNumber é de 0 a 3.
startTime long: o horário em que a execução começou, medido por System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado. Esses testes serão repetidos para tentar uma execução adequada.

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

testStarted

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

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

testStarted

public 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

createTestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

Parâmetros
context IInvocationContext

Retorna
ITestStorageClient

getVersion

protected String getVersion ()

Retorna
String