ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.ResultForwarder


Um ITestInvocationListener que encaminha os resultados da invocação para uma lista de outros ouvintes.

Resumo

Construtores públicos

ResultForwarder ( listeners) ResultForwarder ( listeners)

Crie um ResultForwarder .

ResultForwarder ( ITestInvocationListener... listeners)

Construtor de arg de variável alternativa para ResultForwarder .

Construtores protegidos

ResultForwarder ()

Crie um ResultForwarder com configuração de ouvinte adiado.

Métodos públicos

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

Relata uma invocação como ignorada

void invocationStarted ( IInvocationContext context)

Informa o início da chamada de teste.

void testAssumptionFailure ( TestDescription test, String trace)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

void testFailed ( TestDescription test, FailureDescription failure)

Relata a falha de um caso de teste individual.

void testFailed ( TestDescription test, String trace)

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

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

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 test, SkipReason reason)

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

void testStarted ( TestDescription test, 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 test)

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

Métodos protegidos

getListeners ()

Obtenha a lista de ouvintes.

void setListeners ( ITestInvocationListener... listeners)

Defina os ouvintes após a construção.

void setListeners ( listeners) setListeners ( listeners)

Defina os ouvintes após a construção.

Construtores públicos

ResultForwarder

public ResultForwarder ( listeners)

Crie um ResultForwarder .

Parâmetros
listeners : os ITestInvocationListener s reais para encaminhar os resultados para

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Construtor de arg de variável alternativa para ResultForwarder .

Parâmetros
listeners ITestInvocationListener : os ITestInvocationListener s reais para encaminhar resultados

Construtores protegidos

ResultForwarder

protected ResultForwarder ()

Crie um ResultForwarder com configuração de ouvinte adiado. Destinado apenas ao uso por subclasses.

Métodos públicos

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çãoSkipped

public void invocationSkipped (SkipReason reason)

Relata uma invocação como ignorada

Parâmetros
reason SkipReason

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

testeAssunçãoFalha

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
test TestDescription : identifica o teste

trace String : rastreamento de pilha de falha

testeAssunçãoFalha

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamado quando um teste atômico sinaliza que assume uma condição falsa

Parâmetros
test TestDescription : identifica o teste

failure FailureDescription : FailureDescription que descreve a falha e seu contexto.

teste finalizado

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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
test TestDescription : identifica o teste

endTime long : o horário em que o teste terminou, medido via System.currentTimeMillis()

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

teste finalizado

public void testEnded (TestDescription test, 
                 testMetrics)

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
test TestDescription : identifica o teste

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

teste falhou

public void testFailed (TestDescription test, 
                FailureDescription failure)

Relata 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 seu contexto.

teste falhou

public void testFailed (TestDescription test, 
                String trace)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
test TestDescription : identifica o teste

trace String : rastreamento de pilha de falha

testeIgnorado

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

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

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

Parâmetros
errorMessage 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 acontece. 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 acontece. 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 elapsedTime)

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
elapsedTime long : tempo decorrido relatado pelo dispositivo, em milissegundos

teste ignorado

public void testSkipped (TestDescription test, 
                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
test TestDescription : identifica o teste

reason SkipReason : SkipReason

teste iniciado

public void testStarted (TestDescription test, 
                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
test TestDescription : identifica o teste

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

teste iniciado

public void testStarted (TestDescription test)

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
test TestDescription : identifica o teste

Métodos protegidos

getListeners

protected  getListeners ()

Obtenha a lista de ouvintes. Destinado apenas ao uso por subclasses.

Devoluções
A lista de ITestInvocationListener s.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Defina os ouvintes após a construção. Destinado apenas ao uso por subclasses.

Parâmetros
listeners ITestInvocationListener : os ITestInvocationListener s reais para encaminhar resultados

setListeners

protected void setListeners ( listeners)

Defina os ouvintes após a construção. Destinado apenas ao uso por subclasses.

Parâmetros
listeners : os ITestInvocationListener s reais para encaminhar os resultados para