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 à InvocationListener de renvoyer un récapitulatif. |
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,
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 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
|
testRunEnded(long elapsedTime,
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 la fin 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 |
String
|
mangleTestRunName(String name)
Cette méthode est exécutée sur tous les noms d'exécution de test transmis au rappel |
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 ms |
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 |
invocationStarted
public void invocationStarted (IInvocationContext context)
Indique le début de l'appel du 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 cas de test.
Paramètres | |
---|---|
test |
TestDescription : identifie le test |
testMetrics |
: ERROR(/Map) des métriques émises |
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"). Remarque : Le nom de données ne doit pas nécessairement être unique par appel. Autrement dit, les implémentateurs doivent pouvoir gérer plusieurs appels avec le même nom de données. |
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. |
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 du test |
testRunStopped
public void testRunStopped (long elapsedTime)
L'exécution du test des rapports s'est arrêtée avant la fin en raison d'une requête de l'utilisateur.
À FAIRE: actuellement inutilisé, envisagez de le supprimer
Paramètres | |
---|---|
elapsedTime |
long : durée écoulée, en millisecondes, indiquée par l'appareil |
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
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 |
mangleTestRunName
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 qui peut être différent et qui sera transmis à l'ITestInvocationListener
en aval spécifié lors de la création.
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 |