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

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Un écouteur proxy pour traduire les noms de méthode, de classe et de package de test lorsque les résultats sont signalés.

Résumé

Constructeurs publics
`NameMangleListener(ITestInvocationListener listener)`

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(Throwable cause)` Signale une invocation incomplète en raison d'une condition d'erreur.
`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`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution 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 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`	`testRunEnded(long elapsedTime, runMetrics)` Signale la fin de l'exécution du test.
`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)` 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`	`testStarted(TestDescription test)` Indique le début d'un scénario de test individuel.

Méthodes protégées
`TestDescription`	`mangleTestId(TestDescription test)` Cette méthode est exécutée sur tous les `TestDescription` transmis aux rappels `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` et `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Cette méthode est exécutée sur tous les noms d'exécution de test transmis au rappel `testRunStarted(String, int)`.

Constructeurs publics

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Paramètres
`listener`	`ITestInvocationListener`

Méthodes publiques

getSummary

public TestSummary getSummary ()

Permet à InvocationListener de renvoyer un récapitulatif.

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 (Throwable cause)

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

Appelé automatiquement par le framework TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Appelé automatiquement par le framework TradeFederation. Les rapporteurs doivent remplacer cette méthode pour prendre en charge les 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 l'échec

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, 
                String trace)

Indique l'échec d'un scénario 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.

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

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 (String errorMessage)

L'exécution du test des rapports a échoué 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)

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

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

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Cette méthode est exécutée sur tous les TestDescription transmis aux rappels testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) et ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). La méthode doit renvoyer un TestDescription éventuellement différent qui sera transmis au ITestInvocationListener en aval spécifié lors de la création.

L'implémentation doit veiller à ne pas modifier l'TestDescription d'origine.

L'implémentation par défaut transmet l'identifiant entrant sans le modifier.

Paramètres
`test`	`TestDescription`

Renvoie
`TestDescription`

Nom d'exécution du test mangle

protected String mangleTestRunName (String name)

Cette méthode est exécutée sur tous les noms d'exécution de test transmis au rappel testRunStarted(String, int). La méthode doit renvoyer un nom d'exécution de test éventuellement différent, qui sera transmis au ITestInvocationListener en aval spécifié lors de la construction.

L'implémentation doit veiller à ne pas modifier le nom d'exécution d'origine.

L'implémentation par défaut transmet le nom de l'exécution de test entrante sans modification.

Paramètres
`name`	`String`

Renvoie
`String`