TestRunResult

public class TestRunResult
extends Object

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

---

Enthält Ergebnisse aus einem einzelnen Testlauf.

Er sorgt für eine genaue Anzahl von Tests und verfolgt unvollständige Tests.

Nicht threadsicher! Die Test-Callbacks* müssen in der richtigen Reihenfolge aufgerufen werden.

Zusammenfassung

Konstanten
String	ERROR_DIVIDER

Öffentliche Konstruktoren
TestRunResult() Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden
void	addTestResult(TestDescription test, TestResult testResult)
Set<TestDescription>	getCompletedTests() Ruft die Menge der abgeschlossenen Tests ab.
long	getElapsedTime() Gibt die verstrichene Zeit der aktuellen Ausführung zurück.
int	getExpectedTestCount() Gibt die Anzahl der Testläufe zurück, die für dieses TestRunResult erwartet werden.
Set<TestDescription>	getFailedTests() Ruft die Menge der fehlgeschlagenen Tests ab.
String	getName()
int	getNumAllFailedTests() Gibt die Gesamtzahl der Tests im Fehlerstatus zurück (fehlgeschlagen, Annahmefehler).
int	getNumCompleteTests() Gibt die Anzahl der abgeschlossenen Tests in diesem Lauf zurück, d. h. mit Status != „incomplete“.
int	getNumTests() Gibt die Anzahl der Tests in diesem Lauf zurück.
int	getNumTestsInState(TestStatus status) Ruft die Anzahl der Tests im angegebenen Status für diesen Lauf ab.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) KOMPATIBILITÄT mit älteren Status.
Set<TestDescription>	getPassedTests() Ruft die Menge der bestandenen Tests ab.
FailureDescription	getRunFailureDescription() Gibt den Deskriptor für den Laufzeitfehler zurück oder null, wenn kein Fehler aufgetreten ist.
String	getRunFailureMessage() Gibt die Fehlermeldung für den fehlgeschlagenen Lauf zurück, null, wenn der Lauf nicht fehlgeschlagen ist.
MultiMap<String, LogFile>	getRunLoggedFiles() Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die mit diesem Testlauf verknüpft sind.
Map<String, String>	getRunMetrics()
HashMap<String, MetricMeasurement.Metric>	getRunProtoMetrics()
long	getStartTime() Gibt die Startzeit des ersten „testRunStart“-Aufrufs zurück.
Map<TestDescription, TestResult>	getTestEntriesInState(Collection<TestStatus> statuses) Ruft die Gruppe von Tests in den angegebenen Status ab.
Map<TestDescription, TestResult>	getTestResults() Gibt eine Karte der Testergebnisse zurück.
Set<TestDescription>	getTestsInState(List<TestStatus> statuses) Ruft die Gruppe von Tests in den angegebenen Status ab.
List<TestResult>	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(List<TestRunResult> testRunResults)
static TestRunResult	merge(List<TestRunResult> testRunResults, MergeStrategy strategy) Mehrere TestRunResults mit demselben testRunName zusammenführen.
void	resetRunFailure() Setzen Sie den Status für fehlgeschlagene Ausführungen 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, HashMap<String, MetricMeasurement.Metric> testMetrics)
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
void	testFailed(TestDescription test, FailureDescription failure)
void	testFailed(TestDescription test, String trace)
void	testIgnored(TestDescription test)
void	testLogSaved(String dataName, LogFile logFile) Informationen dazu, dass eine Datei protokolliert wird, werden gespeichert und dem laufenden Testlauf oder Testlauf zugeordnet.
void	testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics) Neue Benutzeroberfläche mit den neuen Proto-Messwerten.
void	testRunEnded(long elapsedTime, Map<String, String> runMetrics)
void	testRunFailed(FailureDescription failureDescription)
void	testRunFailed(String errorMessage)
void	testRunStarted(String runName, int testCount, long startTime) Benachrichtigung, dass ein Testlauf gestartet wurde.
void	testRunStarted(String runName, int testCount) Benachrichtigung, dass ein Testlauf gestartet wurde.
void	testRunStopped(long elapsedTime)
void	testSkipped(TestDescription test, SkipReason reason)
void	testStarted(TestDescription test, long startTime)
void	testStarted(TestDescription test)

Konstanten

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Konstanter Wert: " ====Next Error==== "

Öffentliche Konstruktoren

TestRunResult

public TestRunResult ()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parameter
test	TestDescription
testResult	TestResult

getCompletedTests

public Set<TestDescription> getCompletedTests ()

Ruft die Menge der abgeschlossenen Tests ab.

Gibt Folgendes zurück:
Set<TestDescription>

getElapsedTime

public long getElapsedTime ()

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

Gibt Folgendes zurück:
long

getExpectedTestCount

public int getExpectedTestCount ()

Gibt die Anzahl der Testläufe zurück, die für dieses TestRunResult erwartet werden. Die tatsächliche Anzahl kann aufgrund von Testabstürzen geringer sein als erwartet. Normalerweise weist eine solche Nichtübereinstimmung auf einen fehlgeschlagenen Testlauf hin.

Gibt Folgendes zurück:
int

getFailedTests

public Set<TestDescription> getFailedTests ()

Ruft die Menge der fehlgeschlagenen Tests ab.

Gibt Folgendes zurück:
Set<TestDescription>

getName

public String getName ()

Gibt Folgendes zurück:
String	Name des Testlaufs

getNumAllFailedTests

public int getNumAllFailedTests ()

Gibt die Gesamtzahl der Tests im Fehlerstatus zurück (fehlgeschlagen, Annahmefehler).

Gibt Folgendes zurück:
int

getNumCompleteTests

public int getNumCompleteTests ()

Gibt die Anzahl der abgeschlossenen Tests in diesem Lauf zurück, d. h. mit Status != „incomplete“.

Gibt Folgendes zurück:
int

getNumTests

public int getNumTests ()

Gibt die Anzahl der Tests in diesem Lauf zurück.

Gibt Folgendes zurück:
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Ruft die Anzahl der Tests im angegebenen Status für diesen Lauf ab.

Parameter
status	TestStatus

Gibt Folgendes zurück:
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

KOMPATIBILITÄT mit älteren Status. Verwenden Sie stattdessen „getNumTestsInState(TestStatus)“.

Parameter
ddmlibStatus	TestResult.TestStatus

Gibt Folgendes zurück:
int

getPassedTests

public Set<TestDescription> getPassedTests ()

Ruft die Menge der bestandenen Tests ab.

Gibt Folgendes zurück:
Set<TestDescription>

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Gibt den Deskriptor für den Laufzeitfehler zurück oder null, wenn kein Fehler aufgetreten ist.

Gibt Folgendes zurück:
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Gibt die Fehlermeldung für den fehlgeschlagenen Lauf zurück, null, wenn der Lauf nicht fehlgeschlagen ist.

Gibt Folgendes zurück:
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Gibt eine Kopie der Karte mit allen protokollierten Dateien zurück, die mit diesem Testlauf verknüpft sind.

Gibt Folgendes zurück:
MultiMap<String, LogFile>

getRunMetrics

public Map<String, String> getRunMetrics ()

Gibt Folgendes zurück:
Map<String, String>	Map der Messwerte für den Testlauf.

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

Gibt Folgendes zurück:
HashMap<String, MetricMeasurement.Metric>	Map der Messwerte des Testlaufs mit dem neuen Proto-Format.

getStartTime

public long getStartTime ()

Gibt die Startzeit des ersten „testRunStart“-Aufrufs zurück.

Gibt Folgendes zurück:
long

getTestEntriesInState

public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

Ruft die Gruppe von Tests in den angegebenen Status ab.

Parameter
statuses	Collection

Gibt Folgendes zurück:
Map<TestDescription, TestResult>

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

Gibt eine Karte der Testergebnisse zurück.

Gibt Folgendes zurück:
Map<TestDescription, TestResult>

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

Ruft die Gruppe von Tests in den angegebenen Status ab.

Parameter
statuses	List

Gibt Folgendes zurück:
Set<TestDescription>

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

Gibt alle TestResult in einem bestimmten Status zurück.

Parameter
status	TestStatus

Gibt Folgendes zurück:
List<TestResult>

getTextSummary

public String getTextSummary ()

Gibt einen nutzerfreundlichen String zurück, der die Ergebnisse beschreibt.

Gibt Folgendes zurück:
String

hasFailedTests

public boolean hasFailedTests ()

Gibt Folgendes zurück:
boolean	true, wenn bei der Testausführung Tests fehlgeschlagen sind oder Fehler aufgetreten sind.

isRunComplete

public boolean isRunComplete ()

Gibt Folgendes zurück:
boolean	true, wenn der Testlauf abgeschlossen ist.

isRunFailure

public boolean isRunFailure ()

Gibt Folgendes zurück:
boolean	true, wenn der Testlauf fehlgeschlagen ist.

merge

public static TestRunResult merge (List<TestRunResult> testRunResults)

Parameter
testRunResults	List

Gibt Folgendes zurück:
TestRunResult

Weitere Informationen

• merge(List,MergeStrategy)

merge

public static TestRunResult merge (List<TestRunResult> testRunResults, 
                MergeStrategy strategy)

Mehrere TestRunResults mit demselben testRunName zusammenführen. Wenn ein Testlauf in mehreren TestRunResults angezeigt wird, aber unterschiedliche Ergebnisse hat (z.B. „boottest-device“ wird dreimal mit dem Ergebnis FAIL-FAIL-PASS ausgeführt), werden alle Stacktraces der fehlgeschlagenen Läufe verkettet und das endgültige Laufergebnis für Status, Messwerte, Logdateien sowie Start- und Endzeit verwendet.

Parameter
testRunResults	List: Eine Liste der TestRunResult-Objekte, die zusammengeführt werden sollen.
strategy	MergeStrategy: Die Strategie zum Zusammenführen von Ergebnissen.

Gibt Folgendes zurück:
TestRunResult	Das endgültige TestRunResult mit den zusammengeführten Daten aus den TestRunResults.

resetRunFailure

public void resetRunFailure ()

Setzen Sie den Status für fehlgeschlagene Ausführungen zurück.

Beim Wiederholen ist es manchmal erforderlich, den Status des Laufzeitfehlers zurückzusetzen. Dies sollte sorgfältig erfolgen, um nicht versehentlich einen tatsächlichen Fehler 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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parameter
test	TestDescription
endTime	long
testMetrics	HashMap

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parameter
test	TestDescription
testMetrics	HashMap

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 dazu, dass eine Datei protokolliert wird, werden gespeichert und dem laufenden Testlauf oder Testlauf zugeordnet.

Parameter
dataName	String: Der Name, der auf die Daten verweist.
logFile	LogFile: Das LogFile-Objekt, das den Speicherort des Objekts und Informationen dazu darstellt.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Neue Benutzeroberfläche mit den neuen Proto-Messwerten.

Parameter
elapsedTime	long
runMetrics	HashMap

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

Parameter
elapsedTime	long
runMetrics	Map

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 Testlauf gestartet wurde.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Benachrichtigung, dass ein Testlauf gestartet wurde.

Parameter
runName	String: Der Name, der dem Testlauf zu Tracking-Zwecken zugeordnet ist.
testCount	int: Die Anzahl der erwarteten Testläufe, 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