ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener
     ↳ com.android.tradefed.testtype.suite.ModuleListener


Listener anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados.

Resumo

Construtores públicos

ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)

Construtor.

Métodos públicos

boolean hasLastAttemptFailed()

Retorna se a última sessão de nova tentativa do listener falhou ou não.

void logAssociation(String dataName, LogFile logFile)

Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto.

void setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)

Define se a tentativa precisa ser informada como isolada.

void setCollectTestsOnly(boolean collectTestsOnly)

Define se estamos coletando apenas os testes.

void setMarkTestsSkipped(boolean skip)

Define se todos os casos de teste serão marcados como pulados.

void setTestMappingSources( testMappingSources)

Define as origens de mapeamento de teste que serão inseridas nas métricas.

void testAssumptionFailure(TestDescription test, String trace)

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

void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

void testEnded(TestDescription test, long endTime, testMetrics)

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

void testEnded(TestDescription test, testMetrics)

Informa o término da execução de um caso de teste individual.

void testFailed(TestDescription test, FailureDescription failure)

Informa a falha de um caso de teste individual.

void testFailed(TestDescription test, String trace)

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

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

void testRunEnded(long elapsedTime, runMetrics)

Informa o fim da execução do teste.

void testRunFailed(FailureDescription failure)

A execução do teste 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 name, int numTests, int attemptNumber)

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

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

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

void testSkipped(TestDescription test, SkipReason reason)

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

void testStarted(TestDescription test, long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para uma medida precisa.

Construtores públicos

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Construtor.

Parâmetros
listener ITestInvocationListener

moduleContext IInvocationContext

Métodos públicos

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Retorna se a última sessão de nova tentativa do listener falhou ou não.

Retorna
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro precisa ser fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto. 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.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Define se a tentativa precisa ser informada como isolada.

Parâmetros
isolation CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Define se estamos coletando apenas os testes.

Parâmetros
collectTestsOnly boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Define se todos os casos de teste serão marcados como pulados.

Parâmetros
skip boolean

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Define as origens de mapeamento de teste que serão inseridas nas métricas.

Parâmetros
testMappingSources

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamada 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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamada 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 o contexto dela.

testEnded

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), em que podemos especificar o horário de término diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long) para uma medição precisa.

Parâmetros
test TestDescription: identifica o teste

endTime long: o tempo em que o teste foi concluído, medido por System.currentTimeMillis()

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

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 as métricas de chave/valor que podem ter sido emitidas durante a execução do caso de teste.

Parâmetros
test TestDescription: identifica o teste

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

testFailed

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 o contexto dela.

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

testIgnored

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)

Parâmetros
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Parâmetros
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim da execução do teste.

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

runMetrics : pares de chave-valor informados no final de uma execução de teste

testRunFailed

public void testRunFailed (FailureDescription failure)

A execução do teste 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 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 name, 
                int numTests, 
                int attemptNumber)

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 de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado três vezes, então precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.

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 de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado granularmente três vezes, ele precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia de 0 a 3.

startTime long: o horário em que a execução começou, medido por System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

É chamado quando um teste é pulado e não é executado por um motivo que não é esperado. Esses testes serão tentados novamente para tentar uma execução adequada.

Parâmetros
test TestDescription: identifica o teste

reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que 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: o momento em que o teste começou, medido por System.currentTimeMillis()