TestRunResult

public class TestRunResult
extends Object

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


Contient les résultats d'une seule série de tests.

Il maintient un nombre précis de tests et suit les tests incomplets.

Non thread-safe ! Les rappels test* doivent être appelés dans l'ordre.

Résumé

Constantes

String ERROR_DIVIDER

Constructeurs publics

TestRunResult()

Créez unTestRunResultvide.

Méthodes publiques

void addTestResult(TestDescription test, TestResult testResult)
getCompletedTests()

Récupère l'ensemble des tests terminés.

long getElapsedTime()

Renvoie la durée écoulée pour l'exécution en cours.

int getExpectedTestCount()

Obtient le nombre de cas de test que ce TestRunResult doit comporter.

getFailedTests()

Récupère l'ensemble des tests ayant échoué.

String getName()
int getNumAllFailedTests()

Renvoie le nombre total de tests en état d'échec (échec, échec d'hypothèse).

int getNumCompleteTests()

Renvoie le nombre de tests complets dans cette exécution (c'est-à-dire avec un état différent de "incomplet").

int getNumTests()

Obtient le nombre de tests dans cette exécution.

int getNumTestsInState(TestStatus status)

Obtient le nombre de tests dans l'état donné pour cette exécution.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

FOR COMPATIBILITY (POUR LA COMPATIBILITÉ) avec l'état "Ancienne version".

getPassedTests()

Récupère l'ensemble des tests réussis.

FailureDescription getRunFailureDescription()

Renvoie le descripteur d'échec de l'exécution ou null si l'exécution n'a pas échoué.

String getRunFailureMessage()

Renvoie le message d'erreur d'échec de l'exécution, null si l'exécution n'a pas échoué.

MultiMap<String, LogFile> getRunLoggedFiles()

Renvoie une copie de la carte contenant tous les fichiers journaux associés à ce cas de test.

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

Renvoie l'heure de début du premier appel testRunStart.

getTestEntriesInState( statuses)

Récupère l'ensemble des tests dans les états donnés.

getTestResults()

Renvoie une carte des résultats du test.

getTestsInState( statuses)

Récupère l'ensemble des tests dans les états donnés.

getTestsResultsInState(TestStatus status)

Renvoie tous les TestResult dans un état particulier.

String getTextSummary()

Renvoie une chaîne conviviale décrivant les résultats.

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge( testRunResults)
static TestRunResult merge( testRunResults, MergeStrategy strategy)

Fusionne plusieurs TestRunResults du même testRunName.

void resetRunFailure()

Réinitialisez l'état d'échec de l'exécution.

void setAggregateMetrics(boolean metricAggregation)
void setRunComplete(boolean runComplete)
void testAssumptionFailure(TestDescription test, String trace)
void testAssumptionFailure(TestDescription test, FailureDescription failure)
void testEnded(TestDescription test, long endTime, testMetrics)
void testEnded(TestDescription test, testMetrics)
void testFailed(TestDescription test, FailureDescription failure)
void testFailed(TestDescription test, String trace)
void testIgnored(TestDescription test)
void testLogSaved(String dataName, LogFile logFile)

Les informations sur un fichier journalisé sont stockées et associées au cas de test ou à l'exécution du test en cours.

void testRunEnded(long elapsedTime, runMetrics)
void testRunFailed(FailureDescription failureDescription)
void testRunFailed(String errorMessage)
void testRunStarted(String runName, int testCount, long startTime)

Notification indiquant qu'une série de tests a commencé.

void testRunStarted(String runName, int testCount)

Notification indiquant qu'une série de tests a commencé.

void testRunStopped(long elapsedTime)
void testSkipped(TestDescription test, SkipReason reason)
void testStarted(TestDescription test, long startTime)
void testStarted(TestDescription test)

Constantes

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Valeur de constante : " ====Next Error==== "

Constructeurs publics

TestRunResult

public TestRunResult ()

Créez unTestRunResultvide.

Méthodes publiques

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Paramètres
test TestDescription

testResult TestResult

getCompletedTests

public  getCompletedTests ()

Récupère l'ensemble des tests terminés.

Renvoie

getElapsedTime

public long getElapsedTime ()

Renvoie la durée écoulée pour l'exécution en cours.

Renvoie
long

getExpectedTestCount

public int getExpectedTestCount ()

Obtient le nombre de cas de test que ce TestRunResult doit comporter. Le nombre réel peut être inférieur au nombre attendu en raison de plantages de tests. En temps normal, une telle incohérence indique un échec de l'exécution du test.

Renvoie
int

getFailedTests

public  getFailedTests ()

Obtient l'ensemble des tests ayant échoué.

Renvoie

getName

public String getName ()

Renvoie
String Nom de l'exécution du test

getNumAllFailedTests

public int getNumAllFailedTests ()

Renvoie le nombre total de tests en état d'échec (échec, échec d'hypothèse).

Renvoie
int

getNumCompleteTests

public int getNumCompleteTests ()

Obtient le nombre de tests complets dans cette exécution (c'est-à-dire avec un état différent de "incomplet").

Renvoie
int

getNumTests

public int getNumTests ()

Obtient le nombre de tests dans cette exécution.

Renvoie
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Obtient le nombre de tests dans l'état donné pour cette exécution.

Paramètres
status TestStatus

Renvoie
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

FOR COMPATIBILITY (POUR LA COMPATIBILITÉ) avec l'état "Ancienne version". Utilisez getNumTestsInState(com.android.tradefed.result.TestStatus) à la place.

Paramètres
ddmlibStatus TestResult.TestStatus

Renvoie
int

getPassedTests

public  getPassedTests ()

Récupère l'ensemble des tests réussis.

Renvoie

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Renvoie le descripteur d'échec de l'exécution ou null si l'exécution n'a pas échoué.

Renvoie
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Renvoie le message d'erreur d'échec de l'exécution, null si l'exécution n'a pas échoué.

Renvoie
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Renvoie une copie de la carte contenant tous les fichiers journaux associés à ce cas de test.

Renvoie
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

Renvoie
ERROR(/Map) des métriques d'exécution du test.

getRunProtoMetrics

public  getRunProtoMetrics ()

Renvoie
ERROR(/Map) des métriques d'exécution du test avec le nouveau format proto.

getStartTime

public long getStartTime ()

Renvoie l'heure de début du premier appel testRunStart.

Renvoie
long

getTestEntriesInState

public  getTestEntriesInState ( statuses)

Récupère l'ensemble des tests dans les états donnés.

Paramètres
statuses

Renvoie

getTestResults

public  getTestResults ()

Renvoie une carte des résultats du test.

Renvoie

getTestsInState

public  getTestsInState ( statuses)

Récupère l'ensemble des tests dans les états donnés.

Paramètres
statuses

Renvoie

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Renvoie tous les TestResult dans un état particulier.

Paramètres
status TestStatus

Renvoie

getTextSummary

public String getTextSummary ()

Renvoie une chaîne conviviale décrivant les résultats.

Renvoie
String

hasFailedTests

public boolean hasFailedTests ()

Renvoie
boolean true si l'exécution du test a échoué ou a généré des erreurs.

isRunComplete

public boolean isRunComplete ()

Renvoie
boolean true si l'exécution du test est terminée.

isRunFailure

public boolean isRunFailure ()

Renvoie
boolean true si l'exécution du test a échoué.

fusionner

public static TestRunResult merge ( testRunResults)

Paramètres
testRunResults

Renvoie
TestRunResult

fusionner

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Fusionne plusieurs TestRunResults du même testRunName. Si un cas de test apparaît dans plusieurs TestRunResults, mais qu'il présente des résultats différents (par exemple, "boottest-device" s'exécute trois fois avec le résultat ÉCHEC-ÉCHEC-RÉUSSITE), nous concaténons toutes les traces de pile des exécutions ÉCHOUÉES et nous faisons confiance au résultat de l'exécution finale pour l'état, les métriques, les fichiers journaux, l'heure de début et l'heure de fin.

Paramètres
testRunResults  : liste des TestRunResult à fusionner.

strategy MergeStrategy : stratégie de fusion adoptée pour fusionner les résultats.

Renvoie
TestRunResult le TestRunResult final contenant les données fusionnées des testRunResults.

resetRunFailure

public void resetRunFailure ()

Réinitialisez l'état d'échec de l'exécution.

Il est parfois nécessaire de réinitialiser l'état d'échec de l'exécution lors d'une nouvelle tentative. Veillez à ne pas effacer une véritable défaillance.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Paramètres
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Paramètres
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Paramètres
test TestDescription

trace String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Paramètres
test TestDescription

failure FailureDescription

testEnded

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

Paramètres
test TestDescription

endTime long

testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Paramètres
test TestDescription

testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Paramètres
test TestDescription

failure FailureDescription

testFailed

public void testFailed (TestDescription test, 
                String trace)

Paramètres
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

Paramètres
test TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Les informations sur un fichier journalisé sont stockées et associées au cas de test ou à l'exécution du test en cours.

Paramètres
dataName String : nom faisant référence aux données.

logFile LogFile : objet LogFile représentant l'emplacement où l'objet a été enregistré et des informations le concernant.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Paramètres
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Paramètres
failureDescription FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Paramètres
errorMessage String

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                long startTime)

Notification indiquant qu'une série de tests a commencé.

Paramètres
runName String : nom associé à l'exécution du test à des fins de suivi.

testCount int : nombre de cas de test attendus associés à l'exécution du test.

startTime long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Notification indiquant qu'une série de tests a commencé.

Paramètres
runName String : nom associé à l'exécution du test à des fins de suivi.

testCount int : nombre de cas de test attendus associés à l'exécution du test.

testRunStopped

public void testRunStopped (long elapsedTime)

Paramètres
elapsedTime long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Paramètres
test TestDescription

reason SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Paramètres
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

Paramètres
test TestDescription