ModuleListener

public class ModuleListener
extends CollectingTestListener

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

---

Ouvinte 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 repetição do ouvinte falhou ou não.
void	logAssociation (String dataName, LogFile logFile) Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.
void	setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation) Define se a tentativa deve ou não ser reportada como isolada.
void	setCollectTestsOnly (boolean collectTestsOnly) Define se estamos ou não apenas coletando os testes.
void	setMarkTestsSkipped (boolean skip) Se deve ou não marcar todos os casos de teste ignorados.
void	setTestMappingSources ( testMappingSources) 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) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Informa o fim 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 será 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) testRunEnded (long elapsedTime, runMetrics) Informa o fim da execução do teste.
void	testRunFailed ( FailureDescription failure) A execução do teste de relatórios falhou 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	testStarted ( TestDescription test, long startTime) Alternativa para testStarted(com.android.tradefed.result.TestDescription) onde também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para medição precisa .

Construtores públicos

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Construtor.

Parâmetros
listener	ITestInvocationListener
moduleContext	IInvocationContext

Métodos públicos

falhou na última tentativa

public boolean hasLastAttemptFailed ()

Retorna se a última sessão de repetição do ouvinte falhou ou não.

devoluções
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, esse retorno de chamada permite fornecer explicitamente uma forte associação.

Parâmetros
dataName	String : O nome dos dados
logFile	LogFile : o LogFile que foi registrado antes e deve ser associado ao caso de teste.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Define se a tentativa deve ou não ser reportada como isolada.

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

setMarkTestsIgnorado

public void setMarkTestsSkipped (boolean skip)

Se deve ou não marcar todos os casos de teste ignorados.

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 : rastreamento de pilha 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 seu contexto.

testeFinalizado

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

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

Parâmetros
test	TestDescription : identifica o teste
endTime	long : a hora em que o teste terminou, medido via System.currentTimeMillis()
testMetrics	: um ERROR(/Map) das métricas emitidas

testeFinalizado

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) não foi chamado, esse 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, 
                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 seu contexto.

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

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 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 chave-valor relatados no final de uma execução de teste com Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

A execução do teste de relatórios falhou devido a uma falha descrita por FailureDescription .

Parâmetros
failure	FailureDescription : FailureDescription descrevendo a falha e seu 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 que descreve 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 do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é 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 do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.
startTime	long : a hora em que a execução começou, medida via System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa para testStarted(com.android.tradefed.result.TestDescription) onde também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para medição precisa .

Parâmetros
test	TestDescription : identifica o teste
startTime	long : a hora em que o teste começou, medido via System.currentTimeMillis()