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) Informa que a chamada foi finalizada, seja com sucesso 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	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 no 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) Informa o início da execução de um módulo.
void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, 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 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	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çãoEncerrada

public void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, seja com sucesso ou devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

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

invocação falhou

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pela estrutura TradeFederation.

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

invocaçãoIniciado

public void invocationStarted (IInvocationContext context)

Informa o início da chamada de teste.

Será chamado automaticamente pela estrutura 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

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.

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 ERROR(/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 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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa o início da execução de um módulo. Esse 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 suite.

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 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
elapsedTimeMillis	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 : ERROR(/String) descrevendo 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 do teste
testCount	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 runName, 
                int testCount)

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

Parâmetros
runName	String : o nome da execução do teste
testCount	int : número total de testes na execução do 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 do teste
testCount	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 ERROR(/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 ERROR(/System#currentTimeMillis())