TestRunResult

public class TestRunResult
extends Object

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

---

Enthält die 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) Kompatibilität mit älteren Status
	getPassedTests() Ruft die Liste der bestandenen Tests ab.
FailureDescription	getRunFailureDescription() Gibt den Fehlerbeschreibungstext für den Ablauf zurück, null, wenn der Ablauf 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 Karte mit den Testergebnissen zurück.
	getTestsInState( statuses) Ruft die Tests in den angegebenen Status 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) Mehrere TestRunResults mit demselben testRunName zusammenführen.
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

ERROR_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

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 ()

Die Anzahl der abgeschlossenen Tests in diesem Durchlauf, d. h. mit dem Status „nicht abgeschlossen“.

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)

Kompatibilität mit älteren Status Verwenden Sie 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 Tests in den angegebenen Status 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 nutzerfreundlichen String zurück, der die Ergebnisse beschreibt.

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)

Mehrere TestRunResults mit demselben testRunName zusammenführen. Wenn ein Testfall in mehreren TestRunResults-Objekten aufgeführt ist, aber unterschiedliche Ergebnisse hat (z.B. „boottest-device“, das dreimal mit den Ergebnissen FAIL-FAIL-PASS ausgeführt wird), werden alle Stack-Traces aus den fehlgeschlagenen Ausführungen zusammengeführt und für Status, Messwerte, Protokolldateien und Start-/Endzeit wird das Ergebnis des letzten Durchlaufs verwendet.

Parameter
testRunResults	: Eine Liste der TestRunResult-Objekte, die zusammengeführt werden sollen.
strategy	MergeStrategy: die Zusammenführungsstrategie, die für die Zusammenführung von Ergebnissen verwendet wird.

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

resetRunFailure

public void resetRunFailure ()

Setzen Sie den Fehlerstatus der Ausführung zurück.

Manchmal ist es beim erneuten Versuch erforderlich, den Fehlerstatus der Ausführung zurückzusetzen. Dies sollte mit Bedacht geschehen, um einen echten Fehler nicht zu löschen.

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

testIgnored

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 zugewiesen 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 zugewiesen 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