ShardListenerGenericName

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
com.android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


Um ITestInvocationListener que coleta resultados de um estilhaço de invocação (também conhecido como uma divisão de invocação para executar 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 chamada foi finalizada, seja com sucesso 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 no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

Retorna True se o relator suportar resultados granulares, caso contrário, false.

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

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

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

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 elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Informa o fim da execução do teste.

void testRunFailed ( FailureDescription failure)

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

ShardListenerGenericName

public ShardListener (ITestInvocationListener main)

Crie um ShardListener .

Parâmetros
main ITestInvocationListener : o ITestInvocationListener deve encaminhar os resultados. Para evitar colisões com outros ShardListener s, este objeto será sincronizado no main ao encaminhar os resultados. E os resultados serão enviados apenas quando o fragmento de invocação for concluído.

Métodos públicos

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

devoluções

invocaçãoEncerrada

public void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, 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

invocação falhou

public void invocationFailed (FailureDescription failure)

Relata 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

invocação falhou

public void invocationFailed (Throwable cause)

Relata 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

invocaçãoIniciado

public void invocationStarted (IInvocationContext context)

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

Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, esse retorno de chamada permite fornecer explicitamente uma forte associação.

Parâmetros
dataName String : O nome dos dados

logFile LogFile : o LogFile que foi registrado antes e deve ser associado ao caso de teste.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parâmetros
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

Retorna True se o relator suportar resultados granulares, caso contrário, false.

devoluções
boolean

testLog

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

Fornece o registro associado ou dados de depuração da chamada 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 String dos dados. por exemplo, "dispositivo_logcat". Observação 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.

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 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 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 suite.

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

Parâmetros
elapsedTime long : tempo decorrido relatado pelo dispositivo, em milissegundos

runMetrics : pares chave-valor 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 falhou devido a uma falha descrita por FailureDescription .

Parâmetros
failure FailureDescription : FailureDescription descrevendo a falha e seu 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 que descreve 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 do 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 que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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()