ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder

ITestInvocationListener qui transfère les résultats de l'appel à une liste d'autres écouteurs.

Résumé

Constructeurs publics

ResultForwarder( listeners)

Créez un élément ResultForwarder.

ResultForwarder(ITestInvocationListener... listeners)

Autre constructeur d'argument de variable pour ResultForwarder.

Constructeurs protégés

ResultForwarder()

Créez un ResultForwarder avec le paramètre d'écouteur différé.

Méthodes publiques

TestSummary getSummary()

Permet à l'écouteur InvocationListener de renvoyer un résumé.

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 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 testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

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

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 runName, int testCount, int attemptNumber)

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

void testRunStarted(String runName, int testCount)

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

void testRunStarted(String runName, int testCount, 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

getListeners()

Permet d'obtenir la liste des écouteurs.

void setListeners(ITestInvocationListener... listeners)

Définissez les écouteurs après la construction.

void setListeners( listeners)

Définissez les écouteurs après la construction.

Constructeurs publics

ResultForwarder

public ResultForwarder ( listeners)

Créez un élément ResultForwarder.

Paramètres
listeners : les ITestInvocationListener réelles auxquelles transmettre les résultats

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Autre constructeur d'argument de variable pour ResultForwarder.

Paramètres
listeners ITestInvocationListener: les ITestInvocationListener réelles auxquelles transmettre les résultats

Constructeurs protégés

ResultForwarder

protected ResultForwarder ()

Créez un ResultForwarder avec le paramètre d'écouteur différé. Destiné à être utilisé uniquement par sous-jacentes.

Méthodes publiques

getSummary

public TestSummary getSummary ()

Permet à l'écouteur InvocationListener de renvoyer un résumé.

Renvoie
TestSummary Valeur TestSummary résumant l'exécution, ou valeur nulle

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

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.

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.

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 runName, 
                int testCount, 
                int attemptNumber)

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

Paramètres
runName String: nom de l'exécution du test
testCount 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 runName, 
                int testCount)

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

Paramètres
runName String: nom de l'exécution du test
testCount int: nombre total de tests en cours d'exécution

Exécution du test démarrée

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

Paramètres
runName String: nom de l'exécution du test
testCount 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

getListeners

protected  getListeners ()

Permet d'obtenir la liste des écouteurs. Destiné uniquement à être utilisé par les sous-classes.

Renvoie
Liste des objets ITestInvocationListener.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Définissez les écouteurs après la construction. Destiné uniquement à être utilisé par les sous-classes.

Paramètres
listeners ITestInvocationListener: les ITestInvocationListener réelles auxquelles transmettre les résultats

setListeners

protected void setListeners ( listeners)

Définissez les écouteurs après la construction. Destiné uniquement à être utilisé par les sous-classes.

Paramètres
listeners : les ITestInvocationListener réelles auxquelles transmettre les résultats