XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

Schreibt JUnit-Ergebnisse in XML-Dateien in einem Format, das mit dem XMLJUnitResultFormatter von Ant kompatibel ist.

Es wird eine separate XML-Datei pro Testlauf erstellt.

Zusammenfassung

Öffentliche Konstruktoren

XmlTestRunListener()

Öffentliche Methoden

void addSystemError(String systemError)

Füge eine Systemfehlermeldung hinzu.

TestRunResult getRunResult()

Gibt die TestRunResult zurück

String getSystemError()

Gibt die Systemfehlermeldung zurück, die in das Element „system-err“ der XML-Datei geschrieben werden soll.

void setHostName(String hostName)
void setReportDir(File file)

Legt die zu verwendende Berichtsdatei fest.

void testAssumptionFailure(TestIdentifier test, String trace)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

void testEnded(TestIdentifier test, 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, 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 numTests)

Meldet den Beginn eines Testlaufs.

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden

getPropertiesAttributes()

Ruft die Attribute der Properties als Schlüssel/Wert-Paare ab, die in den Testbericht aufgenommen werden sollen.

File getResultFile(File reportDir)

Erstellt einen ERROR(/File), in dem der Bericht erstellt wird.

String getTestName(TestIdentifier testId)
String getTestSuiteName()

Öffentliche Konstruktoren

XmlTestRunListener

public XmlTestRunListener ()

Öffentliche Methoden

addSystemError

public void addSystemError (String systemError)

Füge eine Systemfehlermeldung hinzu.

Parameter
systemError String

getRunResult

public TestRunResult getRunResult ()

Gibt die TestRunResult zurück

Returns
TestRunResult die Ergebnisse des Testlaufs.

getSystemError

public String getSystemError ()

Gibt die Systemfehlermeldung zurück, die in das Element „system-err“ der XML-Datei geschrieben werden soll. Das -Element wird nicht erstellt, wenn ein leerer String zurückgegeben wird.

Returns
String

setHostName

public void setHostName (String hostName)

Parameter
hostName String

setReportDir

public void setReportDir (File file)

Legt die zu verwendende Berichtsdatei fest.

Parameter
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

Parameter
test TestIdentifier: Gibt den Test an.
trace String: Stacktrace des Fehlers

testEnded

public void testEnded (TestIdentifier test, 
                 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 : Eine ERROR(/Map) der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#sendStatus ausgegeben werden. Die Einfügereihenfolge wird beibehalten, es sei denn, Sie geben denselben Schlüssel mehrmals aus. Standardmäßig in IInstrumentationResultParser.StatusKeys definierte Schlü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, 
                 runMetrics)

Meldet das Ende des Testlaufs.

Parameter
elapsedTime long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
runMetrics : Eine ERROR(/Map) der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#addResults ausgegeben werden. Die Einfügereihenfolge wird beibehalten, es sei denn, Sie geben denselben Schlüssel mehrmals aus. Standardmäßig in IInstrumentationResultParser.StatusKeys definierte Schlü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 der der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

Meldet den Beginn eines Testlaufs.

Parameter
runName String: der Name des Testlaufs
numTests int: Gesamtzahl der Tests im Testlauf

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor 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.

Geschützte Methoden

getPropertiesAttributes

protected  getPropertiesAttributes ()

Ruft die Attribute der Properties als Schlüssel/Wert-Paare ab, die in den Testbericht aufgenommen werden sollen.

Returns

getResultFile

protected File getResultFile (File reportDir)

Erstellt einen ERROR(/File), in dem der Bericht erstellt wird.

Parameter
reportDir File: das Stammverzeichnis des Berichts.
Returns
File eine Datei
Ausgabe
IOException

getTestName

protected String getTestName (TestIdentifier testId)

Parameter
testId TestIdentifier

Returns
String

getTestSuiteName

protected String getTestSuiteName ()

Returns
String