Agrégateur de résultats

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator.

---

un redirecteur spécial qui agrège les résultats au besoin, en fonction de la stratégie de nouvelle tentative qui a été prises.

Résumé

Constructeurs publics
ResultAggregator( listeners, RetryStrategy strategy)

Méthodes publiques
void	cleanEventsFiles()
final void	forwardAggregatedInvocationLogs() Transférez tous les journaux au niveau de l'appel aux rapporteurs de résultats qui ne sont pas compatibles avec la méthode résultats.
void	invocationEnded(long elapsedTime) Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur .
void	invocationFailed(FailureDescription failure)
void	invocationFailed(Throwable cause) Signale un appel incomplet en raison d'une condition d'erreur.
void	invocationSkipped(SkipReason reason) Signale un appel comme ignoré
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 test, mais la possibilité de Ainsi, sur la ligne directe testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) n'est pas possible.
void	setLogSaver(ILogSaver logSaver)
void	setUpdatedReporting(boolean updatedReporting) Définit le nouveau rapport.
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 l'heure de fin directement.
void	testFailed(TestDescription test, FailureDescription failure) Indique l'échec d'un scénario de test individuel.
void	testFailed(TestDescription test, String trace) Indique l'échec d'un scénario de test individuel.
void	testIgnored(TestDescription test) Appelé lorsqu'un test n'est pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
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 elapsedTime, runMetrics) Signale la fin de l'exécution du test.
void	testRunFailed(FailureDescription failure) Échec de l'exécution du test des rapports 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 name, 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 ne s'est pas exécuté pour une raison inattendue.
void	testStarted(TestDescription test, long startTime) Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également quand le test a été et ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Méthodes protégées
File[]	getEventsLogs()

Constructeurs publics

Agrégateur de résultats

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

Paramètres
listeners
strategy	RetryStrategy

Méthodes publiques

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

Transférez tous les journaux au niveau de l'appel aux rapporteurs de résultats qui ne sont pas compatibles avec la méthode résultats.

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur .

Sera automatiquement appelée par le framework TradeFederation.

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

échec de l'appel

public void invocationFailed (FailureDescription failure)

Paramètres
failure	FailureDescription

échec de l'appel

public void invocationFailed (Throwable cause)

Signale un appel incomplet en raison d'une condition d'erreur.

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
cause	Throwable: cause de l'échec (Throwable)

Appel ignoré

public void invocationSkipped (SkipReason reason)

Signale un appel comme ignoré

Paramètres
reason	SkipReason

appel démarré

public void invocationStarted (IInvocationContext context)

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

Sera automatiquement appelée par le framework TradeFederation. Les auteurs de rapports doivent ignorer pour créer des rapports sur plusieurs appareils.

Paramètres
context	IInvocationContext: informations sur l'appel

association log

public void logAssociation (String dataName, 
                LogFile logFile)

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

Paramètres
dataName	String: nom des données
logFile	LogFile: le LogFile qui a été consigné précédemment et doit être associé à scénario de test.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Paramètres
logSaver	ILogSaver

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

Définit le nouveau rapport.

Paramètres
updatedReporting	boolean

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 défaillance

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.

Terminé

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

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier l'heure de fin directement. Combinez-le avec 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

Échec du test

public void testFailed (TestDescription test, 
                FailureDescription failure)

Indique l'échec d'un scénario 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)

Indique l'échec d'un scénario 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 n'est 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.

JournalTest

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Paramètres
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

JournalTest enregistré

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Paramètres
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

TestModuleEnded

public void testModuleEnded ()

Indique la fin d'une exécution de module.

Module de test démarré

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 utilise modules: exécuteurs basés sur une suite.

Paramètres
moduleContext	IInvocationContext: IInvocationContext du module.

TestRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Signale la fin de l'exécution du test. FIXME: Nous ne pouvons pas avoir deux éléments Map<> des interfaces de différents types, donc nous devons utiliser HashMap ici.

Paramètres
elapsedTime	long: temps écoulé indiqué par l'appareil, en millisecondes
runMetrics	: paires clé/valeur signalées à la fin d'un test avec Metric.

TestRunFailed

public void testRunFailed (FailureDescription failure)

Échec de l'exécution du test des rapports 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)

Échec de l'exécution du test des rapports en raison d'une erreur fatale.

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

Exécution du test démarrée

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

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

Paramètres
name	String: nom de l'exécution du test
testCount	int: nombre total de tests en cours d'exécution
attemptNumber	int: numéro de commande identifiant les différentes tentatives du même runName qui sont exécutées plusieurs fois. La valeur tryNumber est indexée par 0 et doit s'incrémenter chaque fois qu'une une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise et doit comporter quatre exécutions au total. sous le même nom d'exécution, et le numéro de tentative est compris entre 0 et 3.
startTime	long: heure de début de l'exécution, mesurée via System.currentTimeMillis()

Test ignoré

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue. 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

Démarrage du test démarré

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également quand le test a été et 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()

Méthodes protégées

Journaux getEvents

protected File[] getEventsLogs ()

Renvoie
File[]