É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 IBuildInfo de getInvocationContext().

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getMergedTestRunResults()

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

IInvocationContext getModuleContextForRunResult(String testRunName)

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

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getRunResults()

<ph type="x-smartling-placeholder"></ph> Cette méthode est obsolète. Utiliser getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Renvoyez 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)

Récupère toutes les tentatives d'une TestRunResult d'une exécution de test donnée.

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) n'est pas possible.

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 MergeStrategy à utiliser lors de la fusion des résultats.

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 testEnded(TestDescription test, testMetrics)

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, 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 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 à 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.

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

public  getMergedTestRunResults ()

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

public  getRunResults ()

<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

public  getTestRunAttempts (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

public  getTestRunForAttempts (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

public  getTestRunNames ()

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