ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Sous-classes directes connues FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer FilteredResultForwarder Variante de ResultForwarder qui n'autorise qu'une liste d'autorisation de TestDescription à être signalée.  JarHostTest.HostTestListener Écouteur de wrapper qui transmet tous les événements, à l'exception de testRunStarted() et testRunEnded(), à l'écouteur intégré.  LogSaverResultForwarder Un ResultForwarder pour enregistrer les journaux avec l'outil d'enregistrement de fichiers global.  LogcatCrashResultForwarder Écouteur spécial : en cas d'échec (plantage du processus d'instrumentation), il tente d'extraire le plantage du logcat et l'ajoute au message d'échec associé au test.  PythonBinaryHostTest.PythonForwarder Transmetteur de résultats pour remplacer le nom de l'exécution par le nom du binaire.  ResultAndLogForwarder Redirecteur pour les résultats et les événements de journaux.  RetryResultForwarder Extension de ResultForwarder qui envoie toujours à un numéro de tentative donné.  ShardMainResultForwarder ResultForwarder qui combine les résultats des appels de test segmentés.  TestTimeoutEnforcer Écouteurs permettant de vérifier le temps d'exécution d'un cas de test donné et de le faire échouer s'il dépasse un délai d'attente donné.

Sous-classes indirectes connues GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector Classe d'assistance pour détecter les débuts et fins de course manquants.  ModuleResultsAndMetricsForwarder Extension de ResultAndLogForwarder qui ajoute des métriques supplémentaires liées au module aux résultats du test.  RemoteTestTimeOutEnforcer Écouteurs permettant de vérifier la durée d'exécution d'une configuration de test donnée et de la faire échouer si elle dépasse un délai d'inactivité donné.  RetryLogSaverResultForwarder Transmetteur qui gère également la transmission de la tentative actuelle.

---

ITestInvocationListener qui transmet les résultats d'invocation à une liste d'autres écouteurs.

Résumé

Constructeurs publics
ResultForwarder(ITestInvocationListener... listeners) Constructeur d'arguments de variable alternatif pour ResultForwarder.
ResultForwarder( listeners) Créez un élément ResultForwarder.

Constructeurs protégés
ResultForwarder() Crée un ResultForwarder avec le paramètre d'écouteur différé.

Méthodes publiques
	getListeners() Obtenez la liste des écouteurs.
TestSummary	getSummary() Permet à InvocationListener de renvoyer un récapitulatif.
void	invocationEnded(long elapsedTime) Indique que l'appel s'est terminé, que ce soit avec succès ou en raison d'une condition d'erreur.
void	invocationFailed(FailureDescription failure) Signale une invocation incomplète en raison d'une condition d'erreur.
void	invocationFailed(Throwable cause) Signale une invocation incomplète en raison d'une condition d'erreur.
void	invocationSkipped(SkipReason reason) Signale une invocation comme ignorée
void	invocationStarted(IInvocationContext context) Indique le début de l'appel de test.
void	testAssumptionFailure(TestDescription test, String trace) Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
void	testEnded(TestDescription test, long endTime, testMetrics) Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) où nous pouvons spécifier directement l'heure de fin.
void	testEnded(TestDescription test, testMetrics) Indique la fin de l'exécution d'un cas de test individuel.
void	testFailed(TestDescription test, FailureDescription failure) Signalement de l'échec d'un cas de test individuel.
void	testFailed(TestDescription test, String trace) Signalement de l'échec d'un cas de test individuel.
void	testIgnored(TestDescription test) Appelé lorsqu'un test ne sera 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 de l'exécution d'un module.
void	testModuleStarted(IInvocationContext moduleContext) Indique le début de l'exécution d'un module.
void	testRunEnded(long elapsedTime, runMetrics) Rapports de fin de série de tests.
void	testRunFailed(FailureDescription failure) L'exécution du test des rapports n'a pas pu être effectuée en raison d'un échec décrit par FailureDescription.
void	testRunFailed(String errorMessage) L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.
void	testRunStarted(String runName, int testCount, int attemptNumber) Indique le début d'une série de tests.
void	testRunStarted(String runName, int testCount) Indique le début d'une série de tests.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Indique le début d'une série de tests.
void	testRunStopped(long elapsedTime) L'exécution du test des rapports a été arrêtée avant la fin à la demande d'un utilisateur.
void	testSkipped(TestDescription test, SkipReason reason) Appelée lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison généralement inattendue.
void	testStarted(TestDescription test, long startTime) Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions également la date de début du test, combinée à 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
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 (ITestInvocationListener... listeners)

Constructeur d'arguments de variable alternatif pour ResultForwarder.

Paramètres
listeners	ITestInvocationListener : ITestInvocationListener réels vers lesquels transférer les résultats

ResultForwarder

public ResultForwarder ( listeners)

Créez un élément ResultForwarder.

Paramètres
listeners	: les ITestInvocationListener réels vers lesquels transférer les résultats

Constructeurs protégés

ResultForwarder

protected ResultForwarder ()

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

Méthodes publiques

getListeners

public  getListeners ()

Obtenez la liste des écouteurs.

Renvoie
	Liste des ITestInvocationListener.

getSummary

public TestSummary getSummary ()

Permet à InvocationListener de renvoyer un récapitulatif.

Renvoie
TestSummary	TestSummary résumant l'exécution, ou null

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel s'est terminé, que ce soit avec succès ou en raison d'une condition d'erreur.

Sera automatiquement appelé par le framework TradeFederation.

Paramètres
elapsedTime	long : temps écoulé de l'appel en ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Signale une invocation incomplète en raison d'une condition d'erreur.

Sera automatiquement appelé par le framework TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

Signale une invocation incomplète en raison d'une condition d'erreur.

Sera automatiquement appelé par le framework TradeFederation.

Paramètres
cause	Throwable : cause Throwable de l'échec

invocationSkipped

public void invocationSkipped (SkipReason reason)

Signale une invocation comme ignorée

Paramètres
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Indique le début de l'appel de test.

Sera automatiquement appelé par le framework TradeFederation. Les reporters doivent remplacer cette méthode pour prendre en charge le reporting sur plusieurs appareils.

Paramètres
context	IInvocationContext : informations sur l'appel

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse

Paramètres
test	TestDescription : identifie le test
trace	String : trace de la pile d'échec

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse

Paramètres
test	TestDescription : identifie le test
failure	FailureDescription : FailureDescription décrivant l'échec et son contexte.

testEnded

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

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) où nous pouvons spécifier directement l'heure de fin. Combinez-le avec testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir une mesure précise.

Paramètres
test	TestDescription : identifie le test
endTime	long : heure à laquelle le test s'est terminé, mesurée via System.currentTimeMillis()
testMetrics	: ERROR(/Map) des métriques émises.

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Indique la fin de l'exécution d'un cas de test individuel.

Si testFailed(TestDescription, FailureDescription) n'a pas été appelé, ce test a réussi. Renvoie également toutes les métriques clé/valeur qui ont pu être émises lors de l'exécution du cas de test.

Paramètres
test	TestDescription : identifie le test
testMetrics	: ERROR(/Map) des métriques émises.

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signalement de l'échec d'un cas 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.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Signalement de l'échec d'un cas de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
test	TestDescription : identifie le test
trace	String : trace de la pile d'échec

testIgnored

public void testIgnored (TestDescription test)

Appelé lorsqu'un test ne sera 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

testLog

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 TradeFederation appellera automatiquement cette méthode, en fournissant le journal de l'hôte et, le cas échéant, le logcat de l'appareil.

Paramètres
dataName	String : nom descriptif String des données, par exemple "device_logcat". Remarque : dataName n'est pas forcément unique par invocation. Autrement dit, les implémenteurs doivent pouvoir gérer plusieurs appels avec le même dataName.
dataType	LogDataType : LogDataType des données
dataStream	InputStreamSource : InputStreamSource des données. Les développeurs doivent appeler createInputStream pour commencer à lire les données et s'assurer de fermer l'InputStream résultant une fois l'opération terminée. Les appelants doivent s'assurer que la source des données reste présente et accessible jusqu'à ce que la méthode testLog soit terminée.

testModuleEnded

public void testModuleEnded ()

Indique la fin de l'exécution d'un module.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Indique le début de l'exécution d'un module. Ce rappel est associé à testModuleEnded() et est facultatif dans la séquence. Il n'est utilisé que lors d'une exécution qui utilise des modules : les runners basés sur une suite.

Paramètres
moduleContext	IInvocationContext : IInvocationContext du module.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Rapports de fin de série de tests.

Paramètres
elapsedTime	long : temps écoulé indiqué par l'appareil, en millisecondes
runMetrics	: paires clé/valeur signalées à la fin d'une série de tests

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports n'a pas pu être effectuée 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)

L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.

Paramètres
errorMessage	String : String décrivant la raison de l'échec de l'exécution.

testRunStarted

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

Indique le début d'une série de tests.

Paramètres
runName	String : nom de l'exécution du test
testCount	int : nombre total de tests dans l'exécution du test
attemptNumber	int : numéro de commande, identifiant les différentes tentatives du même runName qui sont exécutées plusieurs fois. attemptNumber est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière précise trois fois, il doit comporter quatre exécutions au total sous le même runName, et attemptNumber doit être compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Indique le début d'une série de tests.

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

testRunStarted

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

Indique le début d'une série de tests.

Paramètres
runName	String : nom de l'exécution du test
testCount	int : nombre total de tests dans l'exécution du test
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 de tentative est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière granulaire trois fois, il doit comporter quatre exécutions au total sous le même runName, et le numéro de tentative est compris entre 0 et 3.
startTime	long : heure de début de l'exécution, mesurée avec System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

L'exécution du test des rapports a été arrêtée avant la fin à la demande d'un utilisateur.

TODO : actuellement inutilisé, pensez à le supprimer

Paramètres
elapsedTime	long : temps écoulé indiqué par l'appareil, en millisecondes

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelée lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison généralement inattendue. Nous allons essayer de relancer ces tests pour tenter de les exécuter correctement.

Paramètres
test	TestDescription : identifie le test
reason	SkipReason : SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions également la date de début du test, combinée à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Paramètres
test	TestDescription : identifie le test
startTime	long : heure à laquelle le test a commencé, mesurée via System.currentTimeMillis()

testStarted

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

setListeners

protected void setListeners (ITestInvocationListener... listeners)

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

Paramètres
listeners	ITestInvocationListener : les ITestInvocationListener réels vers lesquels transférer les résultats

setListeners

protected void setListeners ( listeners)

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

Paramètres
listeners	: ITestInvocationListener réels vers lesquels transférer les résultats