Écouteur segment

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener
     ↳ com.android.tradefed.invoker.ShardListener

Un objet ITestInvocationListener qui collecte les résultats d'un segment d'appel (aussi appelé d'appel divisé pour qu'elles s'exécutent sur plusieurs ressources en parallèle) et les transfère vers une autre l'écouteur.

Résumé

Constructeurs publics

ShardListener(ITestInvocationListener main)

Créez un élément ShardListener.

Méthodes publiques

getUnderlyingResultReporter()
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)

Signale un appel incomplet en raison d'une condition d'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.

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 setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.

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

Fournit les données de journal ou de débogage associées à l'appel de test.

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

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

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

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

Constructeurs publics

Écouteur segment

public ShardListener (ITestInvocationListener main)

Créez un élément ShardListener.

Paramètres
main ITestInvocationListener: le ITestInvocationListener auquel les résultats doivent être transférés. Pour éviter collisions avec d'autres ShardListeners, cet objet sera synchronisé sur main lors du transfert des résultats. Les résultats ne sont envoyés qu'une fois segment d'appel terminé.

Méthodes publiques

getSouslyingResultReporter

public  getUnderlyingResultReporter ()

Renvoie

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 millisecondes

échec de l'appel

public void invocationFailed (FailureDescription failure)

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

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
failure FailureDescription: le FailureDescription décrivant la cause de l'échec

é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 pour 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 cette méthode pour prendre en charge la création de 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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Paramètres
enableGranularResults boolean

assistanceRésultatsGranular

public boolean supportGranularResults ()

Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.

Renvoie
boolean

JournalTest

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

Fournit les données de journal ou de débogage associées à l'appel de test.

Doit être appelé avant ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long))

Le framework Tradefédération appelle automatiquement cette méthode et fournit le journal de l'hôte. et, le cas échéant, le fichier logcat de l'appareil.

Paramètres
dataName String: nom descriptif String des données. Ex. : "device_logcat". Remarque Le nom dataName ne peut pas être unique par appel. Autrement dit, les responsables de la mise en œuvre doivent plusieurs appels avec le même dataName
dataType LogDataType: LogDataType des données
dataStream InputStreamSource: InputStreamSource des données. Les responsables de la mise en œuvre doivent appeler createInputStream pour commencer à lire les données, et veillez à fermer le résultat InputStream une fois l'opération terminée. Les appelants doivent s'assurer que la source des données est conservée et accessibles jusqu'à la fin de la méthode testLog.

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

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

Paramètres
failureMessage 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, 
                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()