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 i test incompleti.

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

Riepilogo

Costanti
String	ERROR_DIVIDER

Costruttori pubblici
TestRunResult() Crea unTestRunResult vuoto.

Metodi pubblici
void	addTestResult(TestDescription test, TestResult testResult)
	getCompletedTests() Restituisce l'insieme dei test completati.
long	getElapsedTime() Restituisce il tempo trascorso dell'esecuzione corrente.
int	getExpectedTestCount() Restituisce il numero di scenari di test che questo TestRunResult prevede di avere.
	getFailedTests() Restituisce l'insieme di test non riusciti.
String	getName()
int	getNumAllFailedTests() Restituisce il numero totale di test in stato di errore (non riuscito, errore di ipotesi)
int	getNumCompleteTests() Restituisce il numero di test completi in questa esecuzione, ovvero con stato != incompleto.
int	getNumTests() Restituisce il numero di test in questa esecuzione.
int	getNumTestsInState(TestStatus status) Restituisce il numero di test nel determinato stato per questa esecuzione.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) PER LA COMPATIBILITÀ con lo stato precedente.
	getPassedTests() Restituisce l'insieme dei test superati.
FailureDescription	getRunFailureDescription() Restituisce il descrittore di errore di esecuzione, null se l'esecuzione non è andata in errore.
String	getRunFailureMessage() Restituisci il messaggio di errore di esecuzione non riuscita, null, se l'esecuzione non è fallita.
MultiMap<String, LogFile>	getRunLoggedFiles() Restituisce una copia della mappa contenente tutti i file di log associati a questo scenario di test.
	getRunMetrics()
	getRunProtoMetrics()
long	getStartTime() Restituisce l'ora di inizio della prima chiamata testRunStart.
	getTestEntriesInState( statuses) Recupera l'insieme di test nei determinati stati.
	getTestResults() Restituisce una mappa dei risultati del test.
	getTestsInState( statuses) Recupera l'insieme di test nei determinati stati.
	getTestsResultsInState(TestStatus status) Restituisce tutti i TestResult in un determinato stato.
String	getTextSummary() Restituisce una stringa di facile comprensione 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 di 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 all'esecuzione del test in corso.
void	testRunEnded(long elapsedTime, runMetrics)
void	testRunFailed(FailureDescription failureDescription)
void	testRunFailed(String errorMessage)
void	testRunStarted(String runName, int testCount, long startTime) Notifica che è iniziata una prova.
void	testRunStarted(String runName, int testCount) Notifica che è iniziata una prova.
void	testRunStopped(long elapsedTime)
void	testSkipped(TestDescription test, SkipReason reason)
void	testStarted(TestDescription test, long startTime)
void	testStarted(TestDescription test)

Costanti

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Constant Value: " ====Next Error==== "

Costruttori pubblici

TestRunResult

public TestRunResult ()

Crea unTestRunResult vuoto.

Metodi pubblici

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parametri
test	TestDescription
testResult	TestResult

getCompletedTests

public  getCompletedTests ()

Restituisce l'insieme dei test completati.

Ritorni

getElapsedTime

public long getElapsedTime ()

Restituisce il tempo trascorso dell'esecuzione corrente.

Ritorni
long

getExpectedTestCount

public int getExpectedTestCount ()

Restituisce il numero di scenari di test che questo TestRunResult prevede di avere. Il numero effettivo potrebbe essere inferiore a quello previsto a causa di arresti anomali del test. Normalmente, una mancata corrispondenza di questo tipo indica un errore di esecuzione del test.

Ritorni
int

getFailedTests

public  getFailedTests ()

Restituisce 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 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 nel determinato stato per questa esecuzione.

Parametri
status	TestStatus

Ritorni
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

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

Parametri
ddmlibStatus	TestResult.TestStatus

Ritorni
int

getPassedTests

public  getPassedTests ()

Restituisce l'insieme dei test superati.

Ritorni

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Restituisce il descrittore di errore di esecuzione, null se l'esecuzione non è andata in errore.

Ritorni
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Restituisci il messaggio di errore di esecuzione non riuscita, null, se l'esecuzione non è fallita.

Ritorni
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Restituisce una copia della mappa contenente tutti i file di log associati a questo scenario di test.

Ritorni
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

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

getRunProtoMetrics

public  getRunProtoMetrics ()

Ritorni
	un 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

getTestEntriesInState

public  getTestEntriesInState ( statuses)

Recupera l'insieme di test nei determinati stati.

Parametri
statuses

Ritorni

getTestResults

public  getTestResults ()

Restituisce una mappa dei risultati del test.

Ritorni

getTestsInState

public  getTestsInState ( statuses)

Recupera l'insieme di test nei determinati stati.

Parametri
statuses

Ritorni

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Restituisce tutti i TestResult in un determinato stato.

Parametri
status	TestStatus

Ritorni

getTextSummary

public String getTextSummary ()

Restituisce una stringa di facile comprensione che descrive i risultati.

Ritorni
String

hasFailedTests

public boolean hasFailedTests ()

Ritorni
boolean	true se l'esecuzione del test ha avuto esito negativo o ha generato errori.

isRunComplete

public boolean isRunComplete ()

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

isRunFailure

public boolean isRunFailure ()

Ritorni
boolean	true se l'esecuzione del test non è riuscita.

unisci

public static TestRunResult merge ( testRunResults)

Parametri
testRunResults

Ritorni
TestRunResult

Vedi anche:

• ERROR(/#merge(List, MergeStrategy))

unisci

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Unisci più TestRunResults dello stesso testRunName. Se uno scenario di test viene visualizzato in più TestRunResults, ma ha risultati diversi (ad es. "boottest-device" viene eseguito tre volte con risultato FAIL-FAIL-PASS), concateniamo tutte le analisi dello stack delle esecuzioni FAILED e ci affidiamo al risultato dell'esecuzione finale 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 unire i risultati.

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

resetRunFailure

public void resetRunFailure ()

Reimposta lo stato di errore di esecuzione.

A volte è necessario reimpostare lo stato di errore dell'esecuzione quando si riprova. 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

testEnded

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

Parametri
test	TestDescription
endTime	long
testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parametri
test	TestDescription
testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parametri
test	TestDescription
failure	FailureDescription

testFailed

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 memorizzate e associate al caso 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

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parametri
failureDescription	FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Parametri
errorMessage	String

testRunStarted

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

Notifica che è iniziata una prova.

Parametri
runName	String: il nome associato all'esecuzione del test a scopo di monitoraggio.
testCount	int: il numero di scenari di test previsti associati all'esecuzione del test.
startTime	long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Notifica che è iniziata una prova.

Parametri
runName	String: il nome associato all'esecuzione del test a scopo di monitoraggio.
testCount	int: il numero di scenari 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