ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.proto.ProtoResultReporter


L'outil de rapport des résultats crée un tampon de protocole TestRecord contenant tous les résultats. Doit être étendu pour gérer ce qu'il faut faire avec le prototype final dans processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord).

Résumé

Constructeurs publics

ProtoResultReporter()

Méthodes publiques

final 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(FailureDescription failure)

Signale un appel incomplet 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 un appel comme ignoré

final void invocationStarted(IInvocationContext context)

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

final void logAssociation(String dataName, LogFile logFile)

Dans certains cas, le journal doit être fortement associé à un scénario test, mais la possibilité de Ainsi, sur la ligne directe testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) n'est pas possible.

void processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)

Utilisez l'enregistrement d'appel pour envoyer un par un tous les journaux finaux de l'appel.

void processFinalProto(TestRecordProto.TestRecord finalRecord)

Gestion du prototype final avec tous les résultats.

void processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Gestion du protocole d'enregistrement de test d'appel partiel après invocationStarted(com.android.tradefed.invoker.IInvocationContext).

void processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)

Gestion du protocole d'enregistrement du scénario de test finalisé après ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

void processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)

Gestion du fichier proto d'enregistrement du scénario de test partiel après testStarted(com.android.tradefed.result.TestDescription, long).

void processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)

Gestion du fichier proto finalisé de l'enregistrement du module après testModuleEnded().

void processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)

Gestion du fichier proto d'enregistrement de module partiel après testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

void processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Gestion du protocole d'enregistrement d'exécution finalisé après ERROR(/#testRunEnded(long,HashMap)) s'est produit.

void processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)

Gestion du fichier proto d'enregistrement d'exécution de test partielle après testRunStarted(String, int) s'est produit.

void setGranularResults(boolean granularResults)
void setInlineRecordOfChildren(boolean inline)
boolean supportGranularResults()

Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.

final void testAssumptionFailure(TestDescription test, String trace)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

final void testEnded(TestDescription test, long endTime, testMetrics)

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier l'heure de fin directement.

void testEnded(TestDescription test, testMetrics)

Indique la fin de l'exécution d'un scénario de test individuel.

final void testFailed(TestDescription test, FailureDescription failure)

Indique l'échec d'un scénario de test individuel.

final void testFailed(TestDescription test, String trace)

Indique l'échec d'un scénario de test individuel.

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

final void testModuleEnded()

Indique la fin d'une exécution de module.

final void testModuleStarted(IInvocationContext moduleContext)

Indique le début d'un module en cours d'exécution.

final void testRunEnded(long elapsedTimeMillis, runMetrics)

Signale la fin de l'exécution du test.

final void testRunFailed(FailureDescription failure)

Échec de l'exécution du test des rapports en raison d'un échec décrit par FailureDescription.

final 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, int attemptNumber)

Indique le début d'une exécution de test.

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

final void testSkipped(TestDescription test, SkipReason reason)

Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue.

final void testStarted(TestDescription test, long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également quand le test a été et ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

final void testStarted(TestDescription test)

Indique le début d'un scénario de test individuel.

Méthodes protégées

TestRecordProto.ChildReference createModuleChildReference(TestRecordProto.TestRecord record)

Crée une référence enfant pour un module.

Constructeurs publics

ProtoResultReporter

public ProtoResultReporter ()

Méthodes publiques

invocationEnded

public final 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 (FailureDescription failure)

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

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
failure FailureDescription: le FailureDescription décrivant la cause de l'échec

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

public void invocationSkipped (SkipReason reason)

Signale un appel comme ignoré

Paramètres
reason SkipReason

appel démarré

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

association log

public final void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à un scénario test, mais la possibilité de Ainsi, sur la ligne directe testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) n'est pas possible. Ainsi, ce rappel permet de fournir une association forte explicitement.

Paramètres
dataName String: nom des données

logFile LogFile: le LogFile qui a été consigné précédemment et doit être associé à scénario de test.

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilisez l'enregistrement d'appel pour envoyer un par un tous les journaux finaux de l'appel.

Paramètres
invocationLogs TestRecordProto.TestRecord: protocole finalisé représentant l'appel.

processusFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestion du prototype final avec tous les résultats.

Paramètres
finalRecord TestRecordProto.TestRecord: le protocole finalisé contenant tous les résultats d'appel.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Gestion du protocole d'enregistrement de test d'appel partiel après invocationStarted(com.android.tradefed.invoker.IInvocationContext).

Paramètres
invocationStartRecord TestRecordProto.TestRecord: fichier proto partiel renseigné après invocationStart.

invocationContext IInvocationContext: appel IInvocationContext.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestion du protocole d'enregistrement du scénario de test finalisé après ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

Paramètres
testCaseRecord TestRecordProto.TestRecord: protocole finalisé représentant un scénario de test.

processTestCase démarré

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Gestion du fichier proto d'enregistrement du scénario de test partiel après testStarted(com.android.tradefed.result.TestDescription, long).

Paramètres
testCaseStartedRecord TestRecordProto.TestRecord: prototype partiel représentant le scénario de test.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Gestion du fichier proto finalisé de l'enregistrement du module après testModuleEnded().

Paramètres
moduleRecord TestRecordProto.TestRecord: prototype finalisé représentant le module.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Gestion du fichier proto d'enregistrement de module partiel après testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

Paramètres
moduleStartRecord TestRecordProto.TestRecord: prototype partiel représentant le module.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Gestion du protocole d'enregistrement d'exécution finalisé après ERROR(/#testRunEnded(long,HashMap)) s'est produit.

Paramètres
runRecord TestRecordProto.TestRecord: prototype final représentant l'exécution.

moduleInProgress boolean: indique si un module est en cours ou non.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestion du fichier proto d'enregistrement d'exécution de test partielle après testRunStarted(String, int) s'est produit.

Paramètres
runStartedRecord TestRecordProto.TestRecord: fichier proto partiel représentant l'exécution.

setGranularResults

public void setGranularResults (boolean granularResults)

Paramètres
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Paramètres
inline boolean

assistanceRésultatsGranular

public boolean supportGranularResults ()

Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.

Renvoie
boolean

TestAssumptionFailure

public final 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 final 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 final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier l'heure de fin directement. Combinez-le avec 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

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 final void testFailed (TestDescription test, 
                FailureDescription failure)

Indique l'échec d'un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
test TestDescription: identifie le test.

failure FailureDescription: FailureDescription décrivant l'échec et son contexte.

Échec du test

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

TestModuleEnded

public final void testModuleEnded ()

Indique la fin d'une exécution de module.

Module de test démarré

public final 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 utilise modules: exécuteurs basés sur une suite.

Paramètres
moduleContext IInvocationContext: IInvocationContext du module.

TestRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 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
elapsedTimeMillis long: temps écoulé indiqué par l'appareil, en millisecondes

runMetrics : paires clé/valeur signalées à la fin d'un test avec Metric.

TestRunFailed

public final void testRunFailed (FailureDescription failure)

Échec de l'exécution du test des rapports en raison d'un échec décrit par FailureDescription.

Paramètres
failure FailureDescription: FailureDescription décrivant l'échec et son contexte.

TestRunFailed

public final 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 du même runName qui sont exécutées plusieurs fois. Le numéro tryNumber est indexé par 0 et doit s'incrémenter à chaque fois. une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise. Il doit en comporter quatre au total. s'exécute sous le même runName, et le tryNumber est compris entre 0 et 3.

Exécution du test démarrée

public final 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 du test démarrée

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 qui sont exécutées plusieurs fois. La valeur tryNumber est indexée par 0 et doit s'incrémenter chaque fois qu'une une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise et doit comporter quatre exécutions au total. sous le même nom d'exécution, et le numéro de tentative est compris entre 0 et 3.

startTime long: heure de début de l'exécution, mesurée via System.currentTimeMillis()

Test ignoré

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue. Ces tests feront l'objet d'une nouvelle tentative pour tenter d'obtenir une exécution correcte.

Paramètres
test TestDescription: identifie le test.

reason SkipReason : SkipReason

Démarrage du test démarré

public final void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également quand le test a été et 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()

Démarrage du test démarré

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

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crée une référence enfant pour un module.

Paramètres
record TestRecordProto.TestRecord

Renvoie
TestRecordProto.ChildReference