Écouteur du test de collecte
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
Un ITestInvocationListener
qui collectera tous les résultats des tests.
Bien que les structures de données utilisées dans cet objet soient thread-safe, les rappels ITestInvocationListener
doivent être appelés dans le bon ordre.
Résumé
Constructeurs publics | |
---|---|
CollectingTestListener()
|
Méthodes publiques | |
---|---|
IBuildInfo
|
getBuildInfo()
<ph type="x-smartling-placeholder"></ph>
Cette méthode est obsolète.
utilisez le |
TestRunResult
|
getCurrentRunResults()
Récupère les résultats de l'exécution du test en cours. |
int
|
getExpectedTests()
Affiche le nombre de tests attendu. |
IInvocationContext
|
getInvocationContext()
Renvoyez le contexte d'appel signalé via |
|
getMergedTestRunResults()
Renvoyez la collection de résultats fusionnée pour toutes les exécutions sur différentes tentatives. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
Renvoie le |
MultiMap<String, LogFile>
|
getModuleLogFiles()
Renvoie une copie de la carte contenant l'ensemble du fichier journal associé au module. |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
Renvoie une copie de la carte contenant tout le fichier journal non associé à une exécution de test ou à de ce module. |
int
|
getNumAllFailedTestRuns()
Renvoie le nombre total d'exécutions de test en échec |
int
|
getNumAllFailedTests()
Renvoie le nombre total de tests en état d'échec (uniquement ceux ayant échoué, les échecs de supposition n'ont pas sont prises en compte). |
int
|
getNumTestsInState(TestStatus status)
Renvoie le nombre de tests dans un état donné pour cette exécution. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
Pour la compatibilité avec un type d'état plus ancien |
int
|
getNumTotalTests()
Renvoie le nombre total de tests complets pour toutes les exécutions. |
IBuildInfo
|
getPrimaryBuildInfo()
Renvoyez les informations sur le build principal signalées via |
|
getRunResults()
<ph type="x-smartling-placeholder"></ph>
Cette méthode est obsolète.
Utiliser |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
Renvoyez |
int
|
getTestRunAttemptCount(String testRunName)
Renvoie le nombre de tentatives pour un nom d'exécution de test donné. |
|
getTestRunAttempts(String testRunName)
Récupère toutes les tentatives d'une |
|
getTestRunForAttempts(int attempt)
Récupère tous les résultats pour une tentative donnée. |
|
getTestRunNames()
Renvoyez tous les noms de toutes les exécutions de test. |
boolean
|
hasFailedTests()
Indique si des tests ayant échoué ou des hypothèses ont échoué pour l'appel. |
boolean
|
hasTestRunResultsForName(String testRunName)
Indique si un nom d'exécution de test donné a des 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(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. |
boolean
|
isDisabled()
Renvoie la valeur "True" si l'objet entier est désactivé (ignorer la configuration et la suppression). |
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 |
void
|
setBuildInfo(IBuildInfo buildInfo)
<ph type="x-smartling-placeholder"></ph> Cette méthode est obsolète. Ce n'est plus nécessaire pour les tests. |
void
|
setDisable(boolean isDisabled)
Détermine si l'objet doit être désactivé. |
void
|
setMergeStrategy(MergeStrategy strategy)
Définit les |
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,
Alternative à |
void
|
testEnded(TestDescription test,
Indique la fin de l'exécution d'un scénario de test individuel. |
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
|
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,
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 |
void
|
testRunFailed(String errorMessage)
Échec de l'exécution du test des rapports en raison d'une erreur fatale. |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
Indique le début d'une exécution de test. |
void
|
testRunStarted(String name, int numTests)
Indique le début d'une exécution de test. |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
Indique le début d'une exécution de test. |
void
|
testRunStopped(long elapsedTime)
L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur. |
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 à |
void
|
testStarted(TestDescription test)
Indique le début d'un scénario de test individuel. |
Méthodes protégées | |
---|---|
final
void
|
clearModuleLogFiles()
Permet de nettoyer le fichier du module afin d'éviter de le 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)
Activer/Désactiver les métriques agrégées option |
Constructeurs publics
Écouteur du test de collecte
public CollectingTestListener ()
Méthodes publiques
getBuildInfo
public IBuildInfo getBuildInfo ()
<ph type="x-smartling-placeholder"></ph>
Cette méthode est obsolète.
utilisez l'IBuildInfo
de getInvocationContext()
.
Renvoie les informations sur la compilation.
Renvoie | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Récupère les résultats de l'exécution du test en cours.
Notez que les résultats peuvent ne pas être complets. Nous vous recommandons de tester la valeur de TestRunResult.isRunComplete()
et/ou (@link TestRunResult#isRunFailure()}, selon le cas).
avant de traiter les résultats.
Renvoie | |
---|---|
TestRunResult |
TestRunResult représentant les données collectées lors du dernier test |
getexpectedTests
public int getExpectedTests ()
Affiche le nombre de tests attendu. Peut être différent de getNumTotalTests()
si
que certains tests n'ont pas été exécutés.
Renvoie | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Renvoyez le contexte d'appel signalé via invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Renvoie | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Renvoyez la collection de résultats fusionnée pour toutes les exécutions sur différentes tentatives.
S'il existe plusieurs résultats, chaque exécution de test est fusionnée avec le résultat le plus récent. en écrasant les résultats des exécutions précédentes. Les exécutions de test sont triées par numéro de tentative.
Les métriques d'une même tentative seront fusionnées en fonction des préférences définies par aggregate-metrics
. Les métriques finales correspondent à celles de la dernière tentative.
Renvoie | |
---|---|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Renvoie le IInvocationContext
du module associé aux résultats.
Paramètres | |
---|---|
testRunName |
String : nom donné par {testRunStarted(String, int) . |
Renvoie | |
---|---|
IInvocationContext |
Le IInvocationContext du module pour un nom d'exécution de test donné null
si aucun résultat ne correspond à ce nom. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Renvoie une copie de la carte contenant l'ensemble du fichier journal associé au module.
Renvoie | |
---|---|
MultiMap<String, LogFile> |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Renvoie une copie de la carte contenant tout le fichier journal non associé à une exécution de test ou à de ce module.
Renvoie | |
---|---|
MultiMap<String, LogFile> |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Renvoie le nombre total d'exécutions de test en échec
Renvoie | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Renvoie le nombre total de tests en état d'échec (uniquement ceux ayant échoué, les échecs de supposition n'ont pas sont prises en compte).
Renvoie | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Renvoie le nombre de tests dans un état donné pour cette exécution.
Paramètres | |
---|---|
status |
TestStatus |
Renvoie | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Pour la compatibilité avec un type d'état plus ancien
Paramètres | |
---|---|
ddmlibStatus |
TestResult.TestStatus |
Renvoie | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Renvoie le nombre total de tests complets pour toutes les exécutions.
Renvoie | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Renvoyez les informations sur le build principal signalées via invocationStarted(com.android.tradefed.invoker.IInvocationContext)
. La compilation principale est celle renvoyée par la première
le fournisseur de compilation de la configuration en cours d'exécution. Renvoie la valeur "null" en l'absence de contexte (aucune compilation
scénario de test).
Renvoie | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
<ph type="x-smartling-placeholder"></ph>
Cette méthode est obsolète.
Utiliser getMergedTestRunResults()
Renvoie les résultats de toutes les exécutions de test.
Renvoie | |
---|---|
|
getTestRunAtTentative
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Renvoyez TestRunResult
pour une seule tentative.
Paramètres | |
---|---|
testRunName |
String : nom donné par {testRunStarted(String, int) . |
attempt |
int : identifiant de la tentative. |
Renvoie | |
---|---|
TestRunResult |
Le TestRunResult pour le nom donné et l'ID de la tentative, ou null le cas échéant
n'existe pas. |
getTestRunRetryCount
public int getTestRunAttemptCount (String testRunName)
Renvoie le nombre de tentatives pour un nom d'exécution de test donné.
Paramètres | |
---|---|
testRunName |
String : nom donné par {testRunStarted(String, int) . |
Renvoie | |
---|---|
int |
Tentatives getTestRun
publicgetTestRunAttempts (String testRunName)
Récupère toutes les tentatives d'une TestRunResult
d'une exécution de test donnée.
Paramètres | |
---|---|
testRunName |
String : nom donné par {testRunStarted(String, int) . |
Renvoie | |
---|---|
|
Toutes les valeurs TestRunResult pour une exécution de test donnée, classées par tentatives. |
getTestRunForTrys
publicgetTestRunForAttempts (int attempt)
Récupère tous les résultats pour une tentative donnée.
Paramètres | |
---|---|
attempt |
int : tentative pour laquelle nous souhaitons obtenir des résultats. |
Renvoie | |
---|---|
|
Tous les TestRunResult pour une tentative donnée. |
Noms des exécutions de test
publicgetTestRunNames ()
Renvoyez tous les noms de toutes les exécutions de test.
Ces exécutions de test peuvent avoir été exécutées plusieurs fois avec des tentatives différentes.
Renvoie | |
---|---|
|
TestsÉchecTests
public boolean hasFailedTests ()
Indique si des tests ayant échoué ou des hypothèses ont échoué pour l'appel.
Renvoie | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Indique si un nom d'exécution de test donné a des résultats.
Paramètres | |
---|---|
testRunName |
String : nom donné par {testRunStarted(String, int) . |
Renvoie | |
---|---|
boolean |
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 (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 |
est désactivé
public boolean isDisabled ()
Renvoie la valeur "True" si l'objet entier est désactivé (ignorer la configuration et la suppression). Sinon, cette valeur est "false".
Renvoie | |
---|---|
boolean |
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. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
<ph type="x-smartling-placeholder"></ph>
Cette méthode est obsolète.
Ce n'est plus nécessaire pour les tests.
Définissez les informations sur la compilation. À utiliser uniquement à des fins de test.
Paramètres | |
---|---|
buildInfo |
IBuildInfo |
DéfinirDésactiver
public void setDisable (boolean isDisabled)
Détermine si l'objet doit être désactivé. "Désactivé" signifie que les étapes de configuration et de suppression doivent être ignorées. Permet de désactiver un objet par défaut d'un constructeur.
Paramètres | |
---|---|
isDisabled |
boolean : état dans lequel l'objet doit être placé. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Définit les MergeStrategy
à utiliser lors de la fusion des résultats.
Paramètres | |
---|---|
strategy |
MergeStrategy |
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 |
Terminé
public void testEnded (TestDescription test,testMetrics)
Indique la fin de l'exécution d'un scénario de test individuel.
Si testFailed(TestDescription, FailureDescription)
n'a pas été appelé, le test a réussi. Renvoie également toute clé-valeur
qui ont pu être émises lors de l'exécution du scénario de test.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
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. |
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 numTests, int attemptNumber)
Indique le début d'une exécution de test.
Paramètres | |
---|---|
name |
String : nom de l'exécution du test |
numTests |
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. Le numéro tryNumber est indexé par 0 et doit s'incrémenter à chaque fois.
une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise. Il doit en comporter quatre au total.
s'exécute sous le même runName, et le tryNumber est compris entre 0 et 3. |
Exécution du test démarrée
public void testRunStarted (String name, int numTests)
Indique le début d'une exécution de test.
Paramètres | |
---|---|
name |
String : nom de l'exécution du test |
numTests |
int : nombre total de tests en cours d'exécution |
Exécution du test démarrée
public void testRunStarted (String name, int numTests, 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 |
numTests |
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() |
Exécution de test arrêtée
public void testRunStopped (long elapsedTime)
L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur.
À FAIRE: actuellement non utilisé, pensez à le supprimer
Paramètres | |
---|---|
elapsedTime |
long : temps écoulé indiqué par l'appareil, en millisecondes |
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() |
Démarrage du test démarré
public void testStarted (TestDescription test)
Indique le début d'un scénario de test individuel. Ancienne interface. Utilisez testStarted(com.android.tradefed.result.TestDescription)
autant que possible.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
Méthodes protégées
ClearModuleLogFiles
protected final void clearModuleLogFiles ()
Permet de nettoyer le fichier du module afin d'éviter de le porter trop longtemps.
ClearResultsForName
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, par exemple est un agrégateur de résultats.
Paramètres | |
---|---|
testRunName |
String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Activer/Désactiver les métriques agrégées option
Paramètres | |
---|---|
aggregate |
boolean |