Cette page a été traduite par l'API Cloud Translation.

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 ne permet de signaler qu'une liste d'autorisation de `TestDescription`.
JarHostTest.HostTestListener	Écouteur de wrapper qui transfère tous les événements, à l'exception de testRunStarted() et testRunEnded(), à l'écouteur intégré.
LogSaverResultForwarder	`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 du logcat le plantage 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 binaire.
ResultAndLogForwarder	Redirecteur des résultats et des événements de journalisation.
RetryResultForwarder	Extension de `ResultForwarder` qui pousse toujours vers un numéro d'essai donné.
ShardMainResultForwarder	`ResultForwarder` qui combine les résultats d'appels de test segmentés.
TestTimeoutEnforcer	Les écouteurs permettent de vérifier la durée d'exécution d'un scénario de test donné et d'échouer en cas de dépassement du délai avant expiration.

Sous-classes indirectes connues

GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Aide de classe pour intercepter le début et la fin de l'exécution manquante.
RetryLogSaverResultForwarder	Transmetteur qui gère également la transmission de la tentative en cours.

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

Résumé

Constructeurs publics
`ResultForwarder(ITestInvocationListener... listeners)` Constructeur d'argument de variable alternatif pour `ResultForwarder`.
`ResultForwarder( listeners)` Créez un élément `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 a pris fin, 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 un appel incomplet 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 du 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 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)` Signale l'échec d'un cas de test individuel.
`void`	`testFailed(TestDescription test, String trace)` Signale 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()` Signale la fin de l'exécution d'un 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)` L'exécution du test des rapports a échoué en raison d'un échec décrit par `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports a échoué 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 du test des rapports s'est arrêtée avant d'être terminée en raison d'une requête de l'utilisateur.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle.
`void`	`testStarted(TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)`, où nous spécifions également le moment où le test a commencé, combiné à `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()` Obtenez la liste des écouteurs.
`void`	`setListeners(ITestInvocationListener... listeners)` Définissez les écouteurs après la création.
`void`	`setListeners( listeners)` Définissez les écouteurs après la création.

Constructeurs publics

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Constructeur d'argument de variable alternatif pour ResultForwarder.

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

ResultForwarder

public ResultForwarder ( listeners)

Créez un élément ResultForwarder.

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

Constructeurs protégés

ResultForwarder

protected ResultForwarder ()

Créez un ResultForwarder avec le paramètre d'écouteur différé. Destiné uniquement aux sous-classes.

Méthodes publiques

getSummary

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

Sera automatiquement appelée 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.

Appelé automatiquement par le framework TradeFederation.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Signale un appel comme ignoré

Paramètres
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Sera automatiquement appelée par le framework TradeFederation. Les signalements doivent remplacer cette méthode pour permettre la création de 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 directement l'heure de fin. Combinez-le à 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

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 est réussi. Renvoie également toutes les métriques 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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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)

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

Appelé entre testStarted et testEnded.

Paramètres
`test`	`TestDescription`: identifie le test.
`trace`	`String`: trace de la pile de l'é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 appelle 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"). Notez que dataName peut ne pas être unique pour chaque appel. Autrement dit, les responsables de la mise en œuvre doivent pouvoir gérer plusieurs appels avec le même dataName.
`dataType`	`LogDataType`: `LogDataType` des données
`dataStream`	`InputStreamSource`: `InputStreamSource` des données. Les implémentateurs doivent appeler createInputStream pour commencer à lire les données et s'assurer de fermer l'InputStream généré une fois la lecture terminée. Les appelants doivent s'assurer que la source des données reste présente et accessible jusqu'à la fin de la méthode testLog.

testModuleEnded

public void testModuleEnded ()

Signale la fin de l'exécution d'un 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 fait appel à des modules, à savoir des 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.

Paramètres
`elapsedTime`	`long`: durée écoulée, en millisecondes, indiquée par l'appareil
`runMetrics`	: paires clé-valeur signalées à la fin d'une exécution de test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports a échoué 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 d'exécution du même runName plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris entre 0 et 3.

testRunStarted

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 dans l'exécution de test

testRunStarted

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 exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque nouvelle exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris entre 0 et 3.
`startTime`	`long`: heure de début de l'exécution, mesurée via `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

L'exécution du test des rapports s'est arrêtée avant d'être terminée en raison d'une requête de l'utilisateur.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle. Nous allons tenter de réexécuter ces tests pour obtenir une exécution correcte.

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 le moment où le test a commencé, combiné à 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()`

testStarted

public void testStarted (TestDescription test)

Indique le début d'un scénario de test individuel. Interface plus ancienne. Utilisez testStarted(com.android.tradefed.result.TestDescription) dans la mesure du possible.

Paramètres
`test`	`TestDescription`: identifie le test

Méthodes protégées

getListeners

protected  getListeners ()

Obtenez la liste des écouteurs. Destiné uniquement à être utilisé par les sous-classes.

Renvoie
	Liste des `ITestInvocationListener`.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Définissez les écouteurs après la création. 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 création. Destiné uniquement à être utilisé par les sous-classes.

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