ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener (link em inglês)
	↳	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 deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível.
void	setAttemptIsolation(CurrentInvocation.IsolationGrade isolation) Define se a tentativa deve ser informada como isolada ou não.
void	setCollectTestsOnly(boolean collectTestsOnly) Define se estamos ou não apenas coletando os testes.
void	setMarkTestsSkipped(boolean skip) Define se todos os casos de teste serão ignorados ou não.
void	setTestMappingSources( testMappingSources) Define origens de mapeamento de teste que serão inseridas nas métricas.
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) 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 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 é 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 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 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 medição 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

associação de registro

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto de retorno de chamada não é possível. 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 deve ser informada como isolada ou não.

Parâmetros
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Define se estamos ou não apenas coletando os testes.

Parâmetros
collectTestsOnly	boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Define se todos os casos de teste serão ignorados ou não.

Parâmetros
skip	boolean

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

Parâmetros
testMappingSources

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

testAssumptionFailure

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 descrevendo a falha e o contexto.

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 horário de término do teste, medido por System.currentTimeMillis().
testMetrics	: um 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 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, 
                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 descrevendo a falha e o contexto.

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)

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. 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 (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 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 de teste.
numTests	int: número total de testes na execução do teste
attemptNumber	int: número do pedido, identificando as diferentes tentativas do mesmo runName executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado todas as vezes ocorre uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro no total é executado com o mesmo runName, e o tryNumber 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 de teste.
numTests	int: número total de testes na execução do teste
attemptNumber	int: número do pedido, identificando as diferentes tentativas do mesmo runName executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado sempre que um uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro execuções no total com o mesmo runName, e o tryNumber vai de 0 a 3.
startTime	long: o horário de início da corrida, medida usando System.currentTimeMillis().

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. Tentaremos realizar esses testes novamente para tentar obter 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 medição precisa.

Parâmetros
test	TestDescription: identifica o teste.
startTime	long: o horário de início do teste, medido por System.currentTimeMillis().