NomeMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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


Um ouvinte proxy para traduzir nomes de métodos de teste, classes e pacotes à medida que os resultados são relatados.

Resumo

Construtores públicos

NameMangleListener ( ITestInvocationListener listener)

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 (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 testAssumptionFailure ( TestDescription test, String trace)

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

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

Informa o final da execução do teste.

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)

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

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

Métodos protegidos

TestDescription mangleTestId ( TestDescription test)

Este método é executado em todos TestDescription s que são passados ​​para testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) retornos de chamada.

String mangleTestRunName (String name)

Este método é executado em todos os nomes de execução de teste que são passados ​​para o retorno de chamada testRunStarted(String, int) .

Construtores públicos

NomeMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parâmetros
listener ITestInvocationListener

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

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

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

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

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Este método é executado em todos TestDescription s que são passados ​​para testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) retornos de chamada. O método deve retornar um TestDescription possivelmente diferente que será passado para o ITestInvocationListener downstream que foi especificado durante a construção.

A implementação deve ter cuidado para não modificar o TestDescription original.

A implementação padrão passa o identificador de entrada sem modificação.

Parâmetros
test TestDescription

Devoluções
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

Este método é executado em todos os nomes de execução de teste que são passados ​​para o retorno de chamada testRunStarted(String, int) . O método deve retornar um nome de execução de teste possivelmente diferente que será passado para o ITestInvocationListener downstream que foi especificado durante a construção.

A implementação deve ter cuidado para não modificar o nome original da execução.

A implementação padrão passa o nome da execução de teste de entrada sem modificação.

Parâmetros
name String

Devoluções
String