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 |
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(
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,
Alternativa a |
void
|
testEnded(TestDescription test,
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,
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 |
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 |
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() |