TestRunResult

public class TestRunResult
extends Object

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

---

Enthält Ergebnisse eines einzelnen Testlaufs.

Erhält eine genaue Anzahl der Tests und überwacht unvollständige Tests.

Nicht threadsicher! Die Callbacks vom Typ „test*“ müssen in der richtigen Reihenfolge aufgerufen werden.

Zusammenfassung

Felder
public static final String	ERROR_DIVIDER

Öffentliche Konstruktoren
TestRunResult() Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden
	getCompletedTests() Ruft die abgeschlossenen Tests ab.
long	getElapsedTime() Gibt die verstrichene Zeit der aktuellen Ausführung zurück.
int	getExpectedTestCount() Die erwartete Anzahl der Testfälle für dieses TestRunResult.
	getFailedTests() Ruft die fehlgeschlagenen Tests ab.
String	getName()
int	getNumAllFailedTests() Die Gesamtzahl der Tests im Fehlerstatus zurückgeben (Fehlgeschlagen, Annahmefehler)
int	getNumCompleteTests() Die Anzahl der abgeschlossenen Tests in diesem Durchlauf, d. h. mit dem Status „nicht abgeschlossen“.
int	getNumTests() Die Anzahl der Tests in diesem Durchlauf.
int	getNumTestsInState(TestStatus status) Die Anzahl der Tests im angegebenen Status für diesen Durchlauf.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) FÜR KOMPATIBILITÄT mit älteren Status.
	getPassedTests() Ruft die Liste der bestandenen Tests ab.
FailureDescription	getRunFailureDescription() Gibt den Ausführungsfehlerdeskriptor null zurück, wenn die Ausführung nicht fehlgeschlagen ist.
String	getRunFailureMessage() Gibt die Fehlermeldung für den Ausführungsfehler zurück, null, wenn die Ausführung nicht fehlgeschlagen ist.
MultiMap<String, LogFile>	getRunLoggedFiles() Gibt eine Kopie der Karte zurück, die alle protokollierten Dateien enthält, die mit diesem Testfall verknüpft sind.
	getRunMetrics()
	getRunProtoMetrics()
long	getStartTime() Gibt den Beginn des ersten Aufrufs von „testRunStart“ zurück.
	getTestResults() Gibt eine Zuordnung der Testergebnisse zurück.
	getTestsInState( statuses) Ruft die Gruppe von Tests mit bestimmten Statuswerten ab.
	getTestsResultsInState(TestStatus status) Gibt alle TestResult in einem bestimmten Status zurück.
String	getTextSummary() Gibt einen nutzerfreundlichen String zurück, der die Ergebnisse beschreibt.
boolean	hasFailedTests()
boolean	isRunComplete()
boolean	isRunFailure()
static TestRunResult	merge( testRunResults)
static TestRunResult	merge( testRunResults, MergeStrategy strategy) Führen Sie mehrere TestRunResults desselben testRunName zusammen.
void	resetRunFailure() Setzen Sie den Fehlerstatus der Ausführung zurück.
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) Informationen zu einer protokollierten Datei werden gespeichert und dem laufenden Testfall oder Testlauf zugeordnet.
void	testRunEnded(long elapsedTime, runMetrics)
void	testRunFailed(FailureDescription failureDescription)
void	testRunFailed(String errorMessage)
void	testRunStarted(String runName, int testCount, long startTime) Benachrichtigung, dass ein Test gestartet wurde.
void	testRunStarted(String runName, int testCount) Benachrichtigung, dass ein Test gestartet wurde.
void	testRunStopped(long elapsedTime)
void	testSkipped(TestDescription test, SkipReason reason)
void	testStarted(TestDescription test, long startTime)
void	testStarted(TestDescription test)

Felder

FEHLER_DIVIDER

public static final String ERROR_DIVIDER

Öffentliche Konstruktoren

TestRunResult

public TestRunResult ()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

getCompletedTests

public  getCompletedTests ()

Ruft die abgeschlossenen Tests ab.

Returns

getElapsedTime (Dauer der verfallenen Zeit)

public long getElapsedTime ()

Gibt die verstrichene Zeit der aktuellen Ausführung zurück.

Returns
long

getExpectedTestCount

public int getExpectedTestCount ()

Die erwartete Anzahl der Testfälle für dieses TestRunResult. Aufgrund von Testabstürzen ist die tatsächliche Anzahl möglicherweise niedriger als die erwartete. Normalerweise weist eine solche Abweichung auf einen Fehler bei der Testausführung hin.

Returns
int

getFailedTests

public  getFailedTests ()

Ruft die fehlgeschlagenen Tests ab.

Returns

getName

public String getName ()

Returns
String	den Namen der Testausführung

getNumAllFailedTests

public int getNumAllFailedTests ()

Die Gesamtzahl der Tests im Fehlerstatus zurückgeben (Fehlgeschlagen, Annahmefehler)

Returns
int

getNumCompleteTests

public int getNumCompleteTests ()

Ruft die Anzahl der vollständigen Tests in diesem Durchlauf ab, d. h. mit dem Status != complete.

Returns
int

getNumTests

public int getNumTests ()

Die Anzahl der Tests in diesem Durchlauf.

Returns
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Die Anzahl der Tests im angegebenen Status für diesen Durchlauf.

Parameter
status	TestStatus

Returns
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

FÜR DIE KOMPATIBILITÄT mit älteren Status. Verwende stattdessen getNumTestsInState(com.android.tradefed.result.TestStatus).

Parameter
ddmlibStatus	TestResult.TestStatus

Returns
int

getPassedTests

public  getPassedTests ()

Ruft die Liste der bestandenen Tests ab.

Returns

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Gibt den Fehlerbeschreibungstext für den Ablauf zurück, null, wenn der Ablauf nicht fehlgeschlagen ist.

Returns
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Gibt die Fehlermeldung für den Ausführungsfehler zurück, null, wenn die Ausführung nicht fehlgeschlagen ist.

Returns
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Gibt eine Kopie der Karte zurück, die alle protokollierten Dateien enthält, die mit diesem Testfall verknüpft sind.

Returns
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

Returns
	ERROR(/Map) der Messwerte für den Testlauf.

getRunProtoMetrics

public  getRunProtoMetrics ()

Returns
	ERROR(/Map) der Messwerte der Testläufe mit dem neuen Proto-Format.

getStartTime

public long getStartTime ()

Gibt den Beginn des ersten Aufrufs von „testRunStart“ zurück.

Returns
long

getTestResults

public  getTestResults ()

Gibt eine Karte mit den Testergebnissen zurück.

Returns

getTestsInState

public  getTestsInState ( statuses)

Ruft die Gruppe von Tests mit bestimmten Statuswerten ab.

Parameter
statuses

Returns

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Gibt alle TestResult in einem bestimmten Status zurück.

Parameter
status	TestStatus

Returns

GetTextSummary

public String getTextSummary ()

Gibt einen benutzerfreundlichen String zur Beschreibung der Ergebnisse zurück.

Returns
String

hasFailedTests

public boolean hasFailedTests ()

Returns
boolean	true, wenn bei der Testausführung fehlgeschlagene oder fehlerhafte Tests aufgetreten sind.

isRunComplete

public boolean isRunComplete ()

Returns
boolean	true, wenn der Test abgeschlossen ist.

isRunFailure

public boolean isRunFailure ()

Returns
boolean	true, wenn der Testlauf fehlgeschlagen ist.

zusammenführen

public static TestRunResult merge ( testRunResults)

Parameter
testRunResults

Returns
TestRunResult

Weitere Informationen:

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

zusammenführen

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Führen Sie mehrere TestRunResults desselben testRunName zusammen. Wenn ein Testfall in mehreren TestRunResults angezeigt wird, aber unterschiedliche Ergebnisse liefert (z.B. „boottest-device“ wird dreimal mit dem Ergebnis „FAIL-FAIL-PASS“ ausgeführt), verketten wir alle Stacktraces der FAILED-Ausführungen und vertrauen dem Endergebnis in Bezug auf Status, Messwerte, Logdateien und Start-/Endzeit an.

Parameter
testRunResults	: Eine Liste von TestRunResult, die zusammengeführt werden sollen.
strategy	MergeStrategy: Die Strategie zur Zusammenführung von Ergebnissen.

Returns
TestRunResult	das endgültige TestRunResult mit den zusammengeführten Daten aus den testRunResults.

resetRunFailure

public void resetRunFailure ()

Setzen Sie den Ausführungsfehlerstatus zurück.

Bei Wiederholungsversuchen ist manchmal das Zurücksetzen des Ausführungsfehlerstatus erforderlich. Dies sollte mit Bedacht erfolgen, um einen echten Fehler nicht zu beheben.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parameter
metricAggregation	boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Parameter
runComplete	boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parameter
test	TestDescription
trace	String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parameter
test	TestDescription
failure	FailureDescription

testEnded

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

Parameter
test	TestDescription
endTime	long
testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parameter
test	TestDescription
testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parameter
test	TestDescription
failure	FailureDescription

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parameter
test	TestDescription
trace	String

testIgnoriert

public void testIgnored (TestDescription test)

Parameter
test	TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Informationen zu einer protokollierten Datei werden gespeichert und dem laufenden Testfall oder Testlauf zugeordnet.

Parameter
dataName	String: Der Name, der auf die Daten verweist.
logFile	LogFile: Das LogFile-Objekt, das angibt, wo das Objekt gespeichert wurde, und Informationen dazu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parameter
elapsedTime	long
runMetrics

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parameter
failureDescription	FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Parameter
errorMessage	String

testRunStarted

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

Benachrichtigung, dass ein Test gestartet wurde.

Parameter
runName	String: Der Name, der dem Testlauf zu Tracking-Zwecken zugeordnet ist.
testCount	int: die Anzahl der erwarteten Testfälle, die mit dem Testlauf verknüpft sind.
startTime	long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Benachrichtigung, dass ein Test gestartet wurde.

Parameter
runName	String: Der Name, der dem Testlauf zu Tracking-Zwecken zugeordnet ist.
testCount	int: die Anzahl der erwarteten Testfälle, die mit dem Testlauf verknüpft sind.

testRunStopped

public void testRunStopped (long elapsedTime)

Parameter
elapsedTime	long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parameter
test	TestDescription
reason	SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parameter
test	TestDescription
startTime	long

testStarted

public void testStarted (TestDescription test)

Parameter
test	TestDescription