CollecteTestÉcouteur

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener en implements ITestInvocationListener, ILogSaverListener

java.lang.Object
??	com.android.tradefed.result.CollectingTestListener

Sous-classes directes connues JsonHttpTestResultReporter , MetricsXMLResultReporter , ModuleListener , ReportPassedTests , ResultAggregator , ShardListener , SuiteResultReporter , XmlResultReporter JsonHttpTestResultReporter Un rapporteur de résultats qui encode les résultats des métriques de test et se branche, les informations de l'appareil dans JSON et POST dans un point de terminaison de service HTTP MétriquesXMLResultReporter MetricsXMLResultReporter écrit les métriques de test et les exécute dans un fichier XML dans un dossier spécifié par le paramètre metrics-folder lors de la phase invocationEnded du test. ModuleListener Listener attaché à chaque IRemoteTest de chaque module afin de recueillir la liste des résultats. RapportTests Réussis Signaler dans un fichier les filtres possibles pour exclure le test réussi. Agrégateur de résultats Transitaire spécial qui agrège les résultats en cas de besoin, en fonction de la stratégie de nouvelle tentative qui a été adoptée. Écouteur d'éclats Un ITestInvocationListener qui recueille les résultats d'un tesson d'invocation (alias une division d'invocation à exécuter sur plusieurs ressources en parallèle), et les transmet à un autre auditeur. SuiteResultReporter Collectez les résultats des tests pour un appel complet de la suite et générez les résultats finaux. XmlResultReporter Écrit les résultats JUnit dans un fichier XML dans un format cohérent avec le XMLJUnitResultFormatter d'Ant.

Sous-classes indirectes connues FormattedGeneratorReporter , XmlFormattedGeneratorReporter FormattedGeneratorReporter Reporter qui permet de générer des rapports dans un format particulier. XmlFormattedGeneratorReporter La mise en œuvre du FormattedGeneratorReporter qui forme les résultats de la suite dans un format XML.

---

Un ITestInvocationListener qui recueillera tous les résultats des tests.

Bien que les structures de données utilisées dans cet objet sont thread-safe, les ITestInvocationListener callbacks doivent être appelés dans l'ordre correct.

Sommaire

Constructeurs publics
CollectingTestListener ()

Méthodes publiques
IBuildInfo	getBuildInfo () Cette méthode est déconseillée. compter sur la IBuildInfo de getInvocationContext() .
TestRunResult	getCurrentRunResults () Obtient les résultats de l'exécution de test en cours.
int	getExpectedTests () Renvoie le nombre de tests attendus.
IInvocationContext	getInvocationContext () Retour le contexte d'invocation qui a été rapporté par invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getMergedTestRunResults () Renvoie la collection fusionnée de résultats pour toutes les exécutions sur différentes tentatives.
IInvocationContext	getModuleContextForRunResult (String testRunName) Retourne le IInvocationContext du module associé aux résultats.
MultiMap<String, LogFile>	getModuleLogFiles () Renvoie une copie de la carte contenant tout le fichier journalisé associé au module
MultiMap<String, LogFile>	getNonAssociatedLogFiles () Renvoie une copie de la carte contenant tous les fichiers enregistrés non associés à un test ou à un module.
int	getNumAllFailedTestRuns () Renvoie le nombre total d'exécutions de test dans un état d'échec
int	getNumAllFailedTests () Renvoie le nombre total de tests dans un état d'échec (uniquement en échec, les échecs d'hypothèse ne sont pas pris en compte).
int	getNumTestsInState (TestResult.TestStatus status) Renvoie le nombre de tests dans l'état donné pour cette exécution.
int	getNumTotalTests () Renvoie le nombre total de tests terminés pour toutes les exécutions.
IBuildInfo	getPrimaryBuildInfo () Retour les informations de construction primaire qui a été rapporté par invocationStarted(com.android.tradefed.invoker.IInvocationContext) .
	getRunResults () Cette méthode est déconseillée. Utilisez getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt (String testRunName, int attempt) Retour à la TestRunResult pour une seule tentative.
int	getTestRunAttemptCount (String testRunName) Renvoie le nombre de tentatives pour un nom d'exécution de test donné.
	getTestRunAttempts (String testRunName) Obtient toutes les tentatives pour un TestRunResult d'un essai donné.
	getTestRunForAttempts (int attempt) Obtient tous les résultats pour une tentative donnée.
	getTestRunNames () Renvoie tous les noms de toutes les exécutions de test.
boolean	hasFailedTests () Renvoie si l'appel a échoué ou s'il a échoué à des tests.
boolean	hasTestRunResultsForName (String testRunName) Renvoie si un nom d'exécution de test donné a des résultats.
void	invocationEnded (long elapsedTime)
void	invocationFailed (Throwable cause)
void	invocationStarted (IInvocationContext context)
void	logAssociation (String dataName, LogFile logFile)
void	setBuildInfo (IBuildInfo buildInfo) Cette méthode est obsolète. Plus nécessaire pour tester.
void	setMergeStrategy (MergeStrategy strategy) Définit le MergeStrategy à utiliser lors de la fusion des résultats.
void	testAssumptionFailure (TestDescription test, String trace)
void	testAssumptionFailure (TestDescription test, FailureDescription failure)
void	testEnded (TestDescription test, long endTime, testMetrics) testEnded (TestDescription test, long endTime, testMetrics)
void	testEnded (TestDescription test, testMetrics) testEnded (TestDescription test, testMetrics)
void	testFailed (TestDescription test, FailureDescription failure)
void	testFailed (TestDescription test, String trace)
void	testIgnored (TestDescription test)
void	testModuleEnded ()
void	testModuleStarted (IInvocationContext moduleContext)
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)
void	testRunFailed (FailureDescription failure)
void	testRunFailed (String errorMessage)
void	testRunStarted (String name, int numTests, int attemptNumber)
void	testRunStarted (String name, int numTests)
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime)
void	testRunStopped (long elapsedTime)
void	testStarted (TestDescription test, long startTime)
void	testStarted (TestDescription test)

Méthodes protégées
final void	clearModuleLogFiles () Permet de nettoyer le fichier du module pour éviter de les porter trop longtemps.
final void	clearResultsForName (String testRunName) Permet d'effacer les résultats pour un nom d'exécution donné.
void	setIsAggregrateMetrics (boolean aggregate) Activez l'option « métriques agrégées »

Constructeurs publics

CollecteTestÉcouteur

public CollectingTestListener ()

Méthodes publiques

getBuildInfo

public IBuildInfo getBuildInfo ()

Cette méthode est déconseillée.
compter sur la IBuildInfo de getInvocationContext() .

Renvoie les informations de construction.

Retour
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Obtient les résultats de l'exécution de test en cours.

Notez que les résultats peuvent ne pas être complets. Il est recommandé de tester la valeur de TestRunResult.isRunComplete() et / ou (@link TestRunResult # isRunFailure ()} selon le cas avant le traitement des résultats.

Retour
TestRunResult	le TestRunResult représentant les données recueillies au cours de la dernière série de tests

getExpectedTests

public int getExpectedTests ()

Renvoie le nombre de tests attendus. Pourraient différer de getNumTotalTests() si certains tests n'ont pas.

Retour
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Retour le contexte d'invocation qui a été rapporté par invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Retour
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

Renvoie la collection fusionnée de résultats pour toutes les exécutions sur différentes tentatives.

S'il existe plusieurs résultats, chaque exécution de test est fusionnée, le dernier résultat de test écrasant les résultats de test des exécutions précédentes. Les tests sont classés par numéro de tentative.

Métriques pour la même tentative seront fusionnés en fonction de l'ensemble de préférence par aggregate-metrics . Les métriques finales seront les métriques de la dernière tentative.

Retour

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Retourne le IInvocationContext du module associé aux résultats.

Paramètres
testRunName	String : Le nom donné par { testRunStarted(String, int) .

Retour
IInvocationContext	Le IInvocationContext du module pour un nom de test donné null s'il n'y a pas de résultats pour ce nom.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Renvoie une copie de la carte contenant tout le fichier journalisé associé au module

Retour
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Renvoie une copie de la carte contenant tous les fichiers enregistrés non associés à un test ou à un module.

Retour
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Renvoie le nombre total d'exécutions de test dans un état d'échec

Retour
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Renvoie le nombre total de tests dans un état d'échec (uniquement en échec, les échecs d'hypothèse ne sont pas pris en compte).

Retour
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Renvoie le nombre de tests dans l'état donné pour cette exécution.

Paramètres
status	TestResult.TestStatus

Retour
int

getNumTotalTests

public int getNumTotalTests ()

Renvoie le nombre total de tests terminés pour toutes les exécutions.

Retour
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Retour les informations de construction primaire qui a été rapporté par invocationStarted(com.android.tradefed.invoker.IInvocationContext) . Le build principal est le build renvoyé par le premier fournisseur de build de la configuration en cours. Renvoie null s'il n'y a pas de contexte (pas de build au scénario de test).

Retour
IBuildInfo

getRunResults

public  getRunResults ()

Cette méthode est déconseillée.
Utilisez getMergedTestRunResults()

Renvoie les résultats de toutes les exécutions de test.

Retour

getTestRunAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Retour à la TestRunResult pour une seule tentative.

Paramètres
testRunName	String : Le nom donné par { testRunStarted(String, int) .
attempt	int : L'id tentative.

Retour
TestRunResult	Le TestRunResult le nom donné et id tentative ou null si elle n'existe pas.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Renvoie le nombre de tentatives pour un nom d'exécution de test donné.

Paramètres
testRunName	String : Le nom donné par { testRunStarted(String, int) .

Retour
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Obtient toutes les tentatives pour un TestRunResult d'un essai donné.

Paramètres
testRunName	String : Le nom donné par { testRunStarted(String, int) .

Retour
	Tous TestRunResult pour un essai donné, ordonné par des tentatives.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Obtient tous les résultats pour une tentative donnée.

Paramètres
attempt	int : La tentative que nous voulons obtenir des résultats pour.

Retour
	Tous TestRunResult pour une tentative donnée.

getTestRunNames

public  getTestRunNames ()

Renvoie tous les noms de toutes les exécutions de test.

Ces tests peuvent avoir été exécutés plusieurs fois avec différentes tentatives.

Retour

a échoué aux tests

public boolean hasFailedTests ()

Renvoie si l'appel a échoué ou s'il a échoué à des tests.

Retour
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Renvoie si un nom d'exécution de test donné a des résultats.

Paramètres
testRunName	String : Le nom donné par { testRunStarted(String, int) .

Retour
boolean

invocationTerminé

public void invocationEnded (long elapsedTime)

Paramètres
elapsedTime	long

échec de l'appel

public void invocationFailed (Throwable cause)

Paramètres
cause	Throwable

invocationDémarrée

public void invocationStarted (IInvocationContext context)

Paramètres
context	IInvocationContext

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Paramètres
dataName	String
logFile	LogFile

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Cette méthode est déconseillée.
Plus nécessaire pour tester.

Définissez les informations de construction. Ne doit être utilisé que pour les tests.

Paramètres
buildInfo	IBuildInfo

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Définit le MergeStrategy à utiliser lors de la fusion des résultats.

Paramètres
strategy	MergeStrategy

testAssomptionÉchec

public void testAssumptionFailure (TestDescription test, 
                String trace)

Paramètres
test	TestDescription
trace	String

testAssomptionÉchec

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Paramètres
test	TestDescription
failure	FailureDescription

testTerminé

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

Paramètres
test	TestDescription
endTime	long
testMetrics

testTerminé

public void testEnded (TestDescription test, 
                 testMetrics)

Paramètres
test	TestDescription
testMetrics

test échoué

public void testFailed (TestDescription test, 
                FailureDescription failure)

Paramètres
test	TestDescription
failure	FailureDescription

test échoué

public void testFailed (TestDescription test, 
                String trace)

Paramètres
test	TestDescription
trace	String

testIgnoré

public void testIgnored (TestDescription test)

Paramètres
test	TestDescription

testModuleTerminé

public void testModuleEnded ()

testModuleDémarré

public void testModuleStarted (IInvocationContext moduleContext)

Paramètres
moduleContext	IInvocationContext

testExécutéTerminé

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Paramètres
elapsedTime	long
runMetrics

testRunFailed

public void testRunFailed (FailureDescription failure)

Paramètres
failure	FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Paramètres
errorMessage	String

testRunStarted

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

Paramètres
name	String
numTests	int
attemptNumber	int

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Paramètres
name	String
numTests	int

testRunStarted

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

Paramètres
name	String
numTests	int
attemptNumber	int
startTime	long

testExécutéArrêté

public void testRunStopped (long elapsedTime)

Paramètres
elapsedTime	long

testDémarré

public void testStarted (TestDescription test, 
                long startTime)

Paramètres
test	TestDescription
startTime	long

testDémarré

public void testStarted (TestDescription test)

Paramètres
test	TestDescription

Méthodes protégées

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Permet de nettoyer le fichier du module pour éviter de les porter trop longtemps.

effacerRésultatsPourNom

protected final void clearResultsForName (String testRunName)

Permet d'effacer les résultats pour un nom d'exécution donné. Ne doit être utilisé que dans certains cas comme l'agrégateur de résultats.

Paramètres
testRunName	String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Activez l'option « métriques agrégées »

Paramètres
aggregate	boolean