ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener (link em inglês)
     ↳ com.android.tradefed.invoker.ShardListener

Um ITestInvocationListener que coleta resultados de um fragmento de invocação (também conhecido como divisão de invocação para ser executada em vários recursos em paralelo) e os encaminha para outro ouvinte.

Resumo

Construtores públicos

ShardListener(ITestInvocationListener main)

Crie um ShardListener.

Métodos públicos

getUnderlyingResultReporter()
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 invocationSkipped(SkipReason reason)

Informa uma invocação como ignorada

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 setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

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

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

Fornece o registro associado ou os dados de depuração da invocação de teste.

void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

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 elapsedTime, 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 failureMessage)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

void testRunStarted(String name, int numTests, int attemptNumber, long startTime)

Informa o início de uma execução de teste.

Construtores públicos

ShardListener

public ShardListener (ITestInvocationListener main)

Crie um ShardListener.

Parâmetros
main ITestInvocationListener: o ITestInvocationListener em que os resultados precisam ser encaminhados. Para evitar colisões com outras ShardListeners, este objeto será sincronizado main ao encaminhar resultados. Além disso, os resultados só são enviados depois que de invocação do fragmento de invocação concluída.

Métodos públicos

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Retorna

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.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa uma invocação como 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 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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parâmetros
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

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

Retorna
boolean

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.

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parâmetros
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

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 elapsedTime, 
                 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
elapsedTime 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 failureMessage)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

Parâmetros
failureMessage String: String descrevendo o motivo da falha na execução.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Informa o início de uma execução de teste.

Parâmetros
name String: o nome da execução de teste.
numTests 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().