SubprocessResultsReporter
public
class
SubprocessResultsReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Implémente ITestInvocationListener
pour être spécifié en tant que résultat_reporter et transmet depuis le sous-processus les résultats des tests, des exécutions de tests et des invocations de tests.
Résumé
Constructeurs publics | |
---|---|
SubprocessResultsReporter()
|
Méthodes publiques | |
---|---|
void
|
close()
|
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(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
|
invocationStarted(IInvocationContext context)
Indique le début de l'appel du test. |
void
|
logAssociation(String dataName, LogFile logFile)
Dans certains cas, le journal doit être fortement associé à un cas de test, mais il n'est pas possible de le faire sur le rappel |
void
|
printEvent(String key, Object event)
Assistant permettant d'imprimer la clé d'événement, puis l'objet JSON. |
void
|
setOutputTestLog(boolean outputTestLog)
Indique si le test doit être consigné ou non. |
boolean
|
supportGranularResults()
Renvoie "True" si le signaleur accepte les résultats détaillés, ou "False" dans le cas contraire. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse |
void
|
testAssumptionFailure(TestDescription testId, FailureDescription failure)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse |
void
|
testEnded(TestDescription testId, long endTime,
Alternative à |
void
|
testEnded(TestDescription testId,
Indique la fin de l'exécution d'un cas de test individuel. |
void
|
testFailed(TestDescription testId, FailureDescription failure)
Signale l'échec d'un cas de test individuel. |
void
|
testFailed(TestDescription testId, String reason)
Signale l'échec d'un cas de test individuel. |
void
|
testIgnored(TestDescription testId)
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 de l'exécution d'un module. |
void
|
testRunEnded(long time,
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 |
void
|
testRunFailed(String reason)
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 arg0)
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
|
testSkipped(TestDescription testId, SkipReason reason)
Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle. |
void
|
testStarted(TestDescription testId, long startTime)
Alternative à |
void
|
testStarted(TestDescription testId)
Indique le début d'un scénario de test individuel. |
Constructeurs publics
SubprocessResultsReporter
public SubprocessResultsReporter ()
Méthodes publiques
fermer
public void close ()
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 (FailureDescription failure)
Signale une invocation incomplète en raison d'une condition d'erreur.
Appelé automatiquement 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 |
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 |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Dans certains cas, le journal doit être fortement associé à un cas de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
direct. Ainsi, ce rappel permet de fournir explicitement une association forte.
Paramètres | |
---|---|
dataName |
String : nom des données |
logFile |
LogFile : LogFile enregistré précédemment et qui doit être associé au cas de test. |
printEvent
public void printEvent (String key, Object event)
Assistant permettant d'imprimer la clé d'événement, puis l'objet JSON.
Paramètres | |
---|---|
key |
String |
event |
Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Indique si le test doit être consigné ou non.
Paramètres | |
---|---|
outputTestLog |
boolean |
supportGranularResults
public boolean supportGranularResults ()
Renvoie "True" si le signaleur accepte les résultats détaillés, ou "False" dans le cas contraire.
Renvoie | |
---|---|
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
Paramètres | |
---|---|
testId |
TestDescription : identifie le test |
trace |
String : trace de la pile de l'échec |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
Paramètres | |
---|---|
testId |
TestDescription : identifie le test |
failure |
FailureDescription : FailureDescription décrivant l'échec et son contexte. |
testEnded
public void testEnded (TestDescription testId, long endTime,metrics)
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 une mesure précise.
Paramètres | |
---|---|
testId |
TestDescription : identifie le test |
endTime |
long : heure à laquelle le test s'est terminé, mesurée via System.currentTimeMillis() |
metrics |
: ERROR(/Map) des métriques émises |
testEnded
public void testEnded (TestDescription testId,metrics)
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 | |
---|---|
testId |
TestDescription : identifie le test |
metrics |
: ERROR(/Map) des métriques émises |
testFailed
public void testFailed (TestDescription testId, FailureDescription failure)
Signale l'échec d'un cas de test individuel.
Appelé entre testStarted et testEnded.
Paramètres | |
---|---|
testId |
TestDescription : identifie le test |
failure |
FailureDescription : FailureDescription décrivant l'échec et son contexte. |
testFailed
public void testFailed (TestDescription testId, String reason)
Signale l'échec d'un cas de test individuel.
Appelé entre testStarted et testEnded.
Paramètres | |
---|---|
testId |
TestDescription : identifie le test |
reason |
String : trace de la pile de l'échec |
testIgnored
public void testIgnored (TestDescription testId)
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 | |
---|---|
testId |
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. |
testModuleEnded
public void testModuleEnded ()
Signale 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 exécuteurs basés sur une suite.
Paramètres | |
---|---|
moduleContext |
IInvocationContext : IInvocationContext du module. |
testRunEnded
public void testRunEnded (long time,runMetrics)
Signale la fin de l'exécution du test.
Paramètres | |
---|---|
time |
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 reason)
L'exécution du test des rapports a échoué en raison d'une erreur fatale.
Paramètres | |
---|---|
reason |
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 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 |
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 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 du 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 dans l'exécution du test |
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 arg0)
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 | |
---|---|
arg0 |
long : durée écoulée, en millisecondes, indiquée par l'appareil |
testSkipped
public void testSkipped (TestDescription testId, 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 | |
---|---|
testId |
TestDescription : identifie le test |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription testId, 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 | |
---|---|
testId |
TestDescription : identifie le test |
startTime |
long : heure à laquelle le test a commencé, mesurée via System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription testId)
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 | |
---|---|
testId |
TestDescription : identifie le test |