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 de proxy pour traduire les noms de méthodes, de classes et de packages de test à mesure que les résultats sont consigné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 s'est arrêté, que ce soit avec succès ou en raison d'une erreur .
`void`	`invocationFailed(Throwable cause)` Signale un appel incomplet en raison d'une condition d'erreur.
`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`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution 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`	`testRunEnded(long elapsedTime, runMetrics)` Signale la fin de l'exécution du test.
`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)` 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`	`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

NomMangleListener

public NameMangleListener (ITestInvocationListener listener)

Paramètres
`listener`	`ITestInvocationListener`

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

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

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

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

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

ID mangleTest

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 une un TestDescription é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 TestDescription d'origine.

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

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 une réponse nom de l'exécution de test qui sera transmis au ITestInvocationListener en aval qui a été spécifiées lors de la construction.

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

L'implémentation par défaut transmet le nom de l'exécution du test entrant sans le modifier.

Paramètres
`name`	`String`

Renvoie
`String`