EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

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

---

Écouteur qui consigne tous les événements qu'il reçoit dans un fichier

Résumé

Constructeurs publics
EventsLoggerListener(String name)

Méthodes publiques
File	getLoggedEvents()
void	invocationEnded(long elapsedTime) Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.
void	invocationFailed(FailureDescription failure) Signale un appel incomplet en raison d'une condition d'erreur.
void	invocationSkipped(SkipReason reason) Signale une invocation comme ignorée
void	invocationStarted(IInvocationContext context) Indique le début de l'appel de test.
void	logAssociation(String dataName, LogFile logFile) Dans certains cas, le journal doit être fortement associé à un scénario de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direct.
void	testAssumptionFailure(TestDescription test, String trace) Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
void	testEnded(TestDescription test, long endTime, testMetrics) Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier directement l'heure de fin.
void	testFailed(TestDescription test, FailureDescription failure) Signale l'échec d'un cas de test individuel.
void	testFailed(TestDescription test, String trace) Signale l'échec d'un cas de test individuel.
void	testIgnored(TestDescription test) Appelé lorsqu'un test ne sera pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.
void	testModuleEnded() Indique la fin d'une exécution de module.
void	testModuleStarted(IInvocationContext moduleContext) Indique le début d'un module en cours d'exécution.
void	testRunEnded(long elapsedTimeMillis, runMetrics) Signale la fin de l'exécution du test.
void	testRunFailed(FailureDescription failure) L'exécution du test des rapports a échoué en raison d'un échec décrit par FailureDescription.
void	testRunFailed(String errorMessage) Échec de l'exécution du test des rapports en raison d'une erreur fatale.
void	testRunStarted(String runName, int testCount, int attemptNumber) Indique le début d'une exécution de test.
void	testRunStarted(String runName, int testCount) Indique le début d'une exécution de test.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Indique le début d'une exécution de test.
void	testSkipped(TestDescription test, SkipReason reason) Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle.
void	testStarted(TestDescription test, long startTime) Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également le moment où le test a commencé, combiné à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Constructeurs publics

EventsLoggerListener

public EventsLoggerListener (String name)

Paramètres
name	String

Méthodes publiques

getLoggedEvents

public File getLoggedEvents ()

Renvoie
File

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
elapsedTime	long: temps écoulé de l'appel en ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Signale une invocation incomplète en raison d'une condition d'erreur.

Sera automatiquement appelée par le framework Tradefédération.

Paramètres
failure	FailureDescription: le FailureDescription décrivant la cause de l'échec

Appel ignoré

public void invocationSkipped (SkipReason reason)

Signale un appel comme ignoré

Paramètres
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Indique le début de l'appel de test.

Sera automatiquement appelée par le framework TradeFederation. Les rapporteurs doivent remplacer cette méthode pour prendre en charge les rapports sur plusieurs appareils.

Paramètres
context	IInvocationContext: informations sur l'appel

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à un scénario de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direct. Ainsi, ce rappel permet de fournir explicitement une association forte.

Paramètres
dataName	String: nom des données
logFile	LogFile: LogFile qui a été enregistré précédemment et qui doit être associé au cas de test.

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

Paramètres
test	TestDescription: identifie le test
trace	String: trace de la pile de l'échec

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

Paramètres
test	TestDescription: identifie le test
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

testEnded

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

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier directement l'heure de fin. Combinez-le à testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir des mesures précises.

Paramètres
test	TestDescription: identifie le test
endTime	long: heure de fin du test, mesurée via System.currentTimeMillis()
testMetrics	: ERROR(/Map) des métriques émises

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signale l'échec d'un cas de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
test	TestDescription: identifie le test
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

Échec du test

public void testFailed (TestDescription test, 
                String trace)

Signale l'échec d'un cas de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
test	TestDescription: identifie le test
trace	String: trace de la pile de défaillance

TestIgnoré

public void testIgnored (TestDescription test)

Appelé lorsqu'un test ne sera pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.

Paramètres
test	TestDescription: identifie le test

testModuleEnded

public void testModuleEnded ()

Signale la fin de l'exécution d'un module.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Indique le début d'un module en cours d'exécution. Ce rappel est associé à testModuleEnded() et est facultatif dans la séquence. Il n'est utilisé que lors d'une exécution qui fait appel à des modules, à savoir des exécuteurs basés sur une suite.

Paramètres
moduleContext	IInvocationContext : IInvocationContext du module.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Signale la fin de l'exécution du test.

Paramètres
elapsedTimeMillis	long: temps écoulé indiqué par l'appareil, en millisecondes
runMetrics	: paires clé-valeur signalées à la fin d'une exécution de test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports a échoué en raison d'un échec décrit par FailureDescription.

Paramètres
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

testRunFailed

public void testRunFailed (String errorMessage)

L'exécution du test des rapports a échoué en raison d'une erreur fatale.

Paramètres
errorMessage	String: String décrivant la raison de l'échec de l'exécution.

testRunStarted

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

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test
attemptNumber	int: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test

testRunStarted

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

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test
attemptNumber	int: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque nouvelle exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris entre 0 et 3.
startTime	long: heure de début de l'exécution, mesurée via System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle. Ces tests feront l'objet d'une nouvelle tentative pour tenter d'obtenir une exécution correcte.

Paramètres
test	TestDescription: identifie le test
reason	SkipReason : SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également quand le test a été lancé, combiné à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Paramètres
test	TestDescription: identifie le test
startTime	long: heure de début du test, mesurée via System.currentTimeMillis()