TestRunResult

public class TestRunResult
extends Object

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


Contiene i risultati di una singola esecuzione del test.

Mantiene un conteggio accurato dei test e monitora quelli incompleti.

Non è thread safe. I callback test* devono essere chiamati in ordine

Riepilogo

Campi

public static final String ERROR_DIVIDER

Costruttori pubblici

TestRunResult()

Crea un'area vuotaTestRunResult.

Metodi pubblici

getCompletedTests()

Recupera l'insieme di test completati.

long getElapsedTime()

Restituisce il tempo dell'esecuzione corrente trascorso.

int getExpectedTestCount()

Restituisce il numero di casi di test previsti per questo TestRunResult.

getFailedTests()

Recupera l'insieme di test non riusciti.

String getName()
int getNumAllFailedTests()

Restituisce il numero totale di test in stato di errore (non riusciti, errore del presupposto)

int getNumCompleteTests()

Restituisce il numero di test completi in questa esecuzione, ad esempio con stato != incompleto.

int getNumTests()

Restituisce il numero di test in questa esecuzione.

int getNumTestsInState(TestStatus status)

Restituisce il numero di test in un determinato stato per questa esecuzione.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

PER COMPATIBILITÀ con lo stato precedente.

getPassedTests()

Recupera l'insieme di test superati.

FailureDescription getRunFailureDescription()

Restituisce il descrittore dell'errore di esecuzione, null se l'esecuzione non ha avuto esito negativo.

String getRunFailureMessage()

Restituisce il messaggio di errore di esecuzione, null, se l'esecuzione non ha avuto esito negativo.

MultiMap<String, LogFile> getRunLoggedFiles()

Restituisce una copia della mappa contenente tutti i file registrati associati al caso di test.

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

Restituisce l'ora di inizio della prima chiamata testRunStart.

getTestResults()

Restituisce una mappa dei risultati del test.

getTestsInState( statuses)

Restituisce l'insieme di test in determinati stati.

getTestsResultsInState(TestStatus status)

Restituisce tutti i TestResult in uno stato specifico.

String getTextSummary()

Restituisce una stringa facile da usare che descrive i risultati.

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

Unisci più TestRunResults dello stesso testRunName.

void resetRunFailure()

Reimposta lo stato di errore dell'esecuzione.

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)

Le informazioni su un file registrato vengono memorizzate e associate al caso di test o alla prova in corso.

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

Invia una notifica che indica l'avvio di un'esecuzione di test.

void testRunStarted(String runName, int testCount)

Invia una notifica per segnalare l'avvio di un test.

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

Campi

DIVIDER_ERRORE

public static final String ERROR_DIVIDER

Costruttori pubblici

TestRunResult

public TestRunResult ()

Crea un'area vuotaTestRunResult.

Metodi pubblici

getCompletedTests

public  getCompletedTests ()

Recupera l'insieme di test completati.

Ritorni

getElapsedTime

public long getElapsedTime ()

Restituisce il tempo dell'esecuzione corrente trascorso.

Ritorni
long

getexpectedTestCount

public int getExpectedTestCount ()

Restituisce il numero di casi di test previsti per questo TestRunResult. Il numero effettivo potrebbe essere inferiore a quello previsto a causa di arresti anomali di test. In genere, una mancata corrispondenza indica un errore di esecuzione del test.

Ritorni
int

getFailedTests

public  getFailedTests ()

Ottiene l'insieme di test non riusciti.

Ritorni

getName

public String getName ()

Ritorni
String il nome dell'esecuzione del test

getNumAllFailedTests

public int getNumAllFailedTests ()

Restituisce il numero totale di test in uno stato di errore (non riuscito, errore di ipotesi)

Ritorni
int

getNumCompleteTests

public int getNumCompleteTests ()

Restituisce il numero di test completi in questa esecuzione, ovvero con stato != incompleto.

Ritorni
int

getNumTests

public int getNumTests ()

Restituisce il numero di test in questa esecuzione.

Ritorni
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Restituisce il numero di test in un determinato stato per questa esecuzione.

Parametri
status TestStatus

Ritorni
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

PER COMPATIBILITÀ con lo stato precedente. Utilizza invece getNumTestsInState(com.android.tradefed.result.TestStatus).

Parametri
ddmlibStatus TestResult.TestStatus

Ritorni
int

getPassedTest

public  getPassedTests ()

Restituisce l'insieme di test superati.

Ritorni

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Restituisce il descrittore dell'errore di esecuzione, null se l'esecuzione non ha avuto esito negativo.

Ritorni
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Restituisce il messaggio di errore di errore di esecuzione null se l'esecuzione non è riuscita.

Ritorni
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Restituisce una copia della mappa contenente tutti i file registrati associati al caso di test.

Ritorni
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

Ritorni
un ERROR(/Map) delle metriche di esecuzione del test.

getRunProtoMetrics

public  getRunProtoMetrics ()

Ritorni
a ERROR(/Map) delle metriche di esecuzione del test con il nuovo formato proto.

getStartTime

public long getStartTime ()

Restituisce l'ora di inizio della prima chiamata testRunStart.

Ritorni
long

getTestResults

public  getTestResults ()

Restituisce una mappa dei risultati del test.

Ritorni

getTestsInState

public  getTestsInState ( statuses)

Recupera l'insieme di test in determinati stati.

Parametri
statuses

Ritorni

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Restituisce tutti i TestResult in uno stato specifico.

Parametri
status TestStatus

Ritorni

getTextSummary

public String getTextSummary ()

Restituisce una stringa semplice che descrive i risultati.

Ritorni
String

hasFailedTests

public boolean hasFailedTests ()

Ritorni
boolean true se l'esecuzione del test ha avuto test non riusciti o con errori.

isRunComplete

public boolean isRunComplete ()

Ritorni
boolean true se l'esecuzione del test è terminata.

Errore isRun

public boolean isRunFailure ()

Ritorni
boolean true se l'esecuzione del test non è andata a buon fine.

unisci

public static TestRunResult merge ( testRunResults)

Parametri
testRunResults

Ritorni
TestRunResult

unisci

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Unisci più TestRunResults dello stesso testRunName. Se un test case viene visualizzato in più TestRunResults, ma ha risultati diversi (ad es. "boottest-device" viene eseguito tre volte con il risultato FAIL-FAIL-PASS), concatenamo tutte le tracce dello stack dalle esecuzioni FAILED e consideriamo attendibile il risultato finale dell'esecuzione per stato, metriche, file di log, ora di inizio/fine.

Parametri
testRunResults : un elenco di TestRunResult da unire.

strategy MergeStrategy: la strategia di unione adottata per l'unione dei risultati.

Ritorni
TestRunResult il TestRunResult finale contenente i dati uniti dei testRunResults.

resetRunFailure

public void resetRunFailure ()

Reimposta lo stato di errore dell'esecuzione.

A volte è necessario reimpostare lo stato di errore di esecuzione per riprovare. Questa operazione deve essere eseguita con attenzione per evitare di cancellare un errore reale.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parametri
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Parametri
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parametri
test TestDescription

trace String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parametri
test TestDescription

failure FailureDescription

testTerminato

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

Parametri
test TestDescription

endTime long

testMetrics

testTerminato

public void testEnded (TestDescription test, 
                 testMetrics)

Parametri
test TestDescription

testMetrics

testNon riuscito

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parametri
test TestDescription

failure FailureDescription

testNon riuscito

public void testFailed (TestDescription test, 
                String trace)

Parametri
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

Parametri
test TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Le informazioni su un file registrato vengono archiviate e associate allo scenario di test o all'esecuzione del test in corso.

Parametri
dataName String: il nome che fa riferimento ai dati.

logFile LogFile: l'oggetto LogFile che rappresenta la posizione in cui è stato salvato l'oggetto e le informazioni relative.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parametri
elapsedTime long

runMetrics

testRunNon riuscito

public void testRunFailed (FailureDescription failureDescription)

Parametri
failureDescription FailureDescription

testRunNon riuscito

public void testRunFailed (String errorMessage)

Parametri
errorMessage String

testRunStarted

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

Invia una notifica per informare che è iniziata un'esecuzione di test.

Parametri
runName String: il nome associato all'esecuzione del test a scopo di monitoraggio.

testCount int: il numero di casi di test previsti associati all'esecuzione del test.

startTime long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Invia una notifica per informare che è iniziata un'esecuzione di test.

Parametri
runName String: il nome associato all'esecuzione del test a scopo di monitoraggio.

testCount int: il numero di casi di test previsti associati all'esecuzione del test.

testRunStopped

public void testRunStopped (long elapsedTime)

Parametri
elapsedTime long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parametri
test TestDescription

reason SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parametri
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

Parametri
test TestDescription