TestRunResult

public class TestRunResult
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.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

Öffentliche Konstruktoren

TestRunResult()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

Set<TestIdentifier> getCompletedTests()

Ruft die Menge der abgeschlossenen Tests ab.

long getElapsedTime()

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

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(TestResult.TestStatus status)

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

String getRunFailureMessage()

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

Map<String, String> getRunMetrics()
Map<TestIdentifierTestResult> getTestResults()

Gibt eine Karte der Testergebnisse zurück.

String getTextSummary()

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

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
void setAggregateMetrics(boolean metricAggregation)
void setRunComplete(boolean runComplete)
void testAssumptionFailure(TestIdentifier test, String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

void testEnded(TestIdentifier test, Map<String, String> testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

void testFailed(TestIdentifier test, String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

void testIgnored(TestIdentifier test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.

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

Meldet das Ende des Testlaufs.

void testRunFailed(String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

void testRunStarted(String runName, int testCount)

Meldet den Beginn eines Testlaufs.

void testRunStopped(long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.

void testStarted(TestIdentifier test)

Meldet den Beginn eines einzelnen Testlaufs.

Öffentliche Konstruktoren

TestRunResult

public TestRunResult ()

Erstellen Sie eine leereTestRunResult.

Öffentliche Methoden

getCompletedTests

public Set<TestIdentifier> getCompletedTests ()

Ruft die Menge der abgeschlossenen Tests ab.

Gibt Folgendes zurück:
Set<TestIdentifier>

getElapsedTime

public long getElapsedTime ()

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

Gibt Folgendes zurück:
long

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 (TestResult.TestStatus status)

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

Parameter
status TestResult.TestStatus

Gibt Folgendes zurück:
int

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

getRunMetrics

public Map<String, String> getRunMetrics ()

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

getTestResults

public Map<TestIdentifierTestResult> getTestResults ()

Gibt eine Karte der Testergebnisse zurück.

Gibt Folgendes zurück:
Map<TestIdentifierTestResult>

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.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parameter
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Parameter
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

Parameter
test TestIdentifier: Gibt den Test an.

trace String: Stacktrace des Fehlers

testEnded

public void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestIdentifier, String) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
test TestIdentifier: Gibt den Test an.

testMetrics Map: Map der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#sendStatus ausgegeben werden. Solange derselbe Schlüssel nicht mehrmals ausgegeben wird, bleibt die Einfügereihenfolge dieselbe. In IInstrumentationResultParser.StatusKeys definierte Standardschlüssel werden aus dieser Map herausgefiltert. ddmlib kann zusätzliche Testmesswerte hinzufügen, die in IInstrumentationResultParser.StatusKeys definiert sind.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test TestIdentifier: Gibt den Test an.

trace String: Stacktrace des Fehlers

testIgnored

public void testIgnored (TestIdentifier test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.

Parameter
test TestIdentifier: Gibt den Test an.

testRunEnded

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

Meldet das Ende des Testlaufs.

Parameter
elapsedTime long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

runMetrics Map: Map der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#addResults ausgegeben werden. Solange derselbe Schlüssel nicht mehrmals ausgegeben wird, bleibt die Einfügereihenfolge dieselbe. In IInstrumentationResultParser.StatusKeys definierte Standardschlüssel werden aus dieser Map herausgefiltert. ddmlib kann zusätzliche Testmesswerte hinzufügen, die in IInstrumentationResultParser.StatusKeys definiert sind.

testRunFailed

public void testRunFailed (String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage String: String, in dem der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Beginn eines Testlaufs.

Parameter
runName String: der Name des Testlaufs

testCount int: Gesamtzahl der Tests im Testlauf

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.

Parameter
elapsedTime long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

testStarted

public void testStarted (TestIdentifier test)

Meldet den Beginn eines einzelnen Testlaufs.

Parameter
test TestIdentifier: Gibt den Test an.