ModuleListener

public class ModuleListener
extends CollectingTestListener

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

---

Écouteur associé à chaque IRemoteTest de chaque module afin de collecter la liste des résultats.

Résumé

Constructeurs publics
ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext) Constructeur.

Méthodes publiques
boolean	hasLastAttemptFailed() Indique si la dernière tentative de l'écouteur a échoué ou non.
void	logAssociation(String dataName, LogFile logFile) Dans certains cas, le journal doit être fortement associé à des cas de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String,LogDataType,InputStreamSource,LogFile) direct.
void	setAttemptIsolation(CurrentInvocation.IsolationGrade isolation) Indique si la tentative doit être signalée comme isolée ou non.
void	setCollectTestsOnly(boolean collectTestsOnly) Indique si nous ne collectons que les tests.
void	setMarkTestsSkipped(boolean skip) Indique s'il faut marquer tous les scénarios de test comme ignorés.
void	setTestMappingSources(List<String> testMappingSources) Définit les sources de mappage des tests qui seront insérées dans les métriques.
void	setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
void	testAssumptionFailure(TestDescription test, String trace) Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) Indique la fin de l'exécution d'un cas de test individuel.
void	testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) Alternative à testEnded(TestDescription,Map) où nous pouvons spécifier directement l'heure de fin.
void	testFailed(TestDescription test, FailureDescription failure) Signalement de l'échec d'un cas de test individuel.
void	testFailed(TestDescription test, String trace) Signalement de 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	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics) Rapports de fin de série de tests.
void	testRunFailed(FailureDescription failure) L'exécution du test des rapports n'a pas pu être effectuée en raison d'un échec décrit par FailureDescription.
void	testRunFailed(String errorMessage) L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.
void	testRunStarted(String name, int numTests, int attemptNumber) Indique le début d'un test.
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) Indique le début d'un test.
void	testSkipped(TestDescription test, SkipReason reason) Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison généralement inattendue.
void	testStarted(TestDescription test, long startTime) Alternative à testStarted(TestDescription) où nous spécifions également la date de début du test, combinée à testEnded(TestDescription,long,Map) pour une mesure précise.

Constructeurs publics

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Constructeur.

Paramètres
listener	ITestInvocationListener
moduleContext	IInvocationContext

Méthodes publiques

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Indique si la dernière tentative de l'écouteur a échoué ou non.

Renvoie
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à des cas de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String,LogDataType,InputStreamSource,LogFile) direct. Ce rappel permet donc de fournir explicitement une association forte.

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Indique si la tentative doit être signalée comme isolée ou non.

Paramètres
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Indique si nous ne collectons que les tests.

Paramètres
collectTestsOnly	boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Indique s'il faut marquer tous les scénarios de test comme ignorés.

Paramètres
skip	boolean

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

Définit les sources de mappage des tests qui seront insérées dans les métriques.

Paramètres
testMappingSources	List

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Paramètres
useModuleResultsForwarder	boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse

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

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Indique la fin de l'exécution d'un cas de test individuel.

Si testFailed(TestDescription, FailureDescription) n'a pas été appelé, ce test a réussi. Renvoie également toutes les métriques clé/valeur qui ont pu être émises lors de l'exécution du cas de test.

Paramètres
test	TestDescription : identifie le test
testMetrics	HashMap : Map des métriques émises.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternative à testEnded(TestDescription,Map) où nous pouvons spécifier directement l'heure de fin. Combinez-le avec testStarted(TestDescription,long) pour obtenir une mesure précise.

Paramètres
test	TestDescription : identifie le test
endTime	long : heure à laquelle le test s'est terminé, mesurée via System.currentTimeMillis()
testMetrics	HashMap : Map des métriques émises.

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signalement de 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.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Signalement de 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 d'échec

testIgnored

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

testLog

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

Paramètres
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

Paramètres
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Rapports de fin de série de tests. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

Paramètres
elapsedTime	long : temps écoulé indiqué par l'appareil, en millisecondes
runMetrics	HashMap : paires clé-valeur signalées à la fin d'une série de tests avec Metric.

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports n'a pas pu être effectuée 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 n'a pas pu être effectuée 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 name, 
                int numTests, 
                int attemptNumber)

Indique le début d'un test.

Paramètres
name	String : nom de l'exécution du test
numTests	int : nombre total de tests dans l'exécution du test
attemptNumber	int : numéro de commande, identifiant les différentes tentatives du même runName qui s'exécutent plusieurs fois. Le numéro de tentative est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière précise trois fois, il doit comporter quatre exécutions au total sous le même runName, et le numéro de tentative doit être compris entre 0 et 3.

testRunStarted

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

Indique le début d'un test.

Paramètres
name	String : nom de l'exécution du test
numTests	int : nombre total de tests dans l'exécution du test
attemptNumber	int : numéro de commande, identifiant les différentes tentatives du même runName qui s'exécutent plusieurs fois. Le numéro de tentative est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière précise trois fois, il doit comporter quatre exécutions au total sous le même runName, et le numéro de tentative 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 ne s'est pas exécuté pour une raison généralement inattendue. Nous allons tenter de relancer ces tests pour essayer de les exécuter correctement.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(TestDescription) où nous spécifions également la date de début du test, combinée à testEnded(TestDescription,long,Map) pour une mesure précise.

Paramètres
test	TestDescription : identifie le test
startTime	long : heure à laquelle le test a commencé, mesurée via System.currentTimeMillis()