EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

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

---

Ouvinte que registra todos os eventos que recebe em um arquivo

Resumo

Construtores públicos
EventsLoggerListener (String name)

Métodos públicos
File	getLoggedEvents ()
void	invocationEnded (long elapsedTime) Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.
void	invocationFailed ( FailureDescription failure) Relata uma invocação incompleta devido a alguma condição de erro.
void	invocationSkipped ( SkipReason reason) Relata uma invocação como ignorada
void	invocationStarted ( IInvocationContext context) Informa o início da chamada de teste.
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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível.
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	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	testModuleEnded () Informa o fim da execução de um módulo.
void	testModuleStarted ( IInvocationContext moduleContext) Relata o início de um módulo em execução.
void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Informa o final 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 runName, int testCount, int attemptNumber) Informa o início de uma execução de teste.
void	testRunStarted (String runName, int testCount) Informa o início de uma execução de teste.
void	testRunStarted (String runName, int testCount, 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 foi executado por um motivo que normalmente não é esperado.
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

EventsLoggerListener

public EventsLoggerListener (String name)

Parâmetros
name	String

Métodos públicos

getLoggedEvents

public File getLoggedEvents ()

Devoluções
File

invocaçãoEnded

public void invocationEnded (long elapsedTime)

Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
elapsedTime	long : o tempo decorrido da invocação em ms

invocaçãoFailed

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
failure	FailureDescription : a FailureDescription que descreve a causa da falha

invocaçãoSkipped

public void invocationSkipped (SkipReason reason)

Relata uma invocação como ignorada

Parâmetros
reason	SkipReason

invocaçãoiniciada

public void invocationStarted (IInvocationContext context)

Informa o início da chamada de teste.

Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a relatórios de vários dispositivos.

Parâmetros
context	IInvocationContext : informações sobre a invocação

logAssociação

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, este retorno de chamada permite fornecer explicitamente uma associação forte.

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

testeAssunçãoFalha

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

testeAssunçãoFalha

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 que descreve a falha e seu contexto.

teste finalizado

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 : o horário em que o teste terminou, medido via System.currentTimeMillis()
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 que descreve 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

testModuleEnded

public void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Relata o início de um módulo em execução. Este retorno de chamada está associado a testModuleEnded() e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em suíte.

Parâmetros
moduleContext	IInvocationContext : o IInvocationContext do módulo.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa o final 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
elapsedTimeMillis	long : tempo decorrido relatado pelo dispositivo, em milissegundos
runMetrics	: pares de valores-chave 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 não foi concluída devido a uma falha descrita por FailureDescription .

Parâmetros
failure	FailureDescription : FailureDescription que descreve 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 runName, 
                int testCount, 
                int attemptNumber)

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 em execução de teste
attemptNumber	int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.

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 em execução de teste

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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 em execução de teste
attemptNumber	int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontecer. por exemplo, um teste é repetido de forma granular 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()

teste ignorado

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. Esses testes serão tentados novamente para tentar obter uma execução adequada.

Parâmetros
test	TestDescription : identifica o teste
reason	SkipReason : SkipReason

teste iniciado

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