NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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


Um listener de proxy para traduzir métodos de teste, classes e nomes de pacotes conforme os resultados são informados.

Resumo

Construtores públicos

NameMangleListener(ITestInvocationListener listener)

Métodos públicos

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 algum erro condição.

void invocationFailed(Throwable cause)

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

void invocationStarted(IInvocationContext context)

Informa o início da invocação do 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)

Informa 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 é executado, geralmente porque um método de teste é anotado com "org.junit.Ignore".

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

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

void testRunEnded(long elapsedTime, runMetrics)

Informa o fim 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)

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

Métodos protegidos

TestDescription mangleTestId(TestDescription test)

Esse método é executado em todos os TestDescriptions transmitidos aos callbacks testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)).

String mangleTestRunName(String name)

Esse método é executado em todos os nomes de execução de teste passados para o método testRunStarted(String, int).

Construtores públicos

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parâmetros
listener ITestInvocationListener

Métodos públicos

getResumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

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

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

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.

testAssumptionFailure

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: stack trace de falha

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna qualquer chave/valor métricas que podem 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

testFailed

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: stack trace de falha

testIgnorado

public void testIgnored (TestDescription test)

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

Parâmetros
test TestDescription: identifica o teste.

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.

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 (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 descrevendo 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 na execução do teste

testRunSStop

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: não usado no momento, considere remover

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

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. A interface mais antiga precisa 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)

Esse método é executado em todos os TestDescriptions transmitidos aos callbacks testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). O método deve retornar uma TestDescription possivelmente diferente que será transmitido para o ITestInvocationListener downstream que foi especificado durante a construção.

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

A implementação padrão transmite o identificador de entrada não modificado.

Parâmetros
test TestDescription

Retorna
TestDescription

Nome da execução de teste mangle

protected String mangleTestRunName (String name)

Esse método é executado em todos os nomes de execução de teste passados para o método testRunStarted(String, int). O método deve retornar uma resposta que será transmitido ao ITestInvocationListener downstream que foi especificado durante a construção.

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

A implementação padrão passa o nome da execução de teste recebida por não modificado.

Parâmetros
name String

Retorna
String