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 übereinstimmt.

Es wird eine separate XML-Datei pro Testlauf erstellt.

Weitere Informationen

• https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd

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 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 numTests) 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.

Geschützte Methoden
Map<String, String>	getPropertiesAttributes() Ruft die Attribute der Eigenschaften als Schlüssel/Wert-Paare ab, die in den Testbericht aufgenommen werden sollen.
File	getResultFile(File reportDir) Erstellt einen 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

Gibt Folgendes zurück:
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.

Gibt Folgendes zurück:
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 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 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 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.

Geschützte Methoden

getPropertiesAttributes

protected Map<String, String> getPropertiesAttributes ()

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

Gibt Folgendes zurück:
Map<String, String>

getResultFile

protected File getResultFile (File reportDir)

Erstellt einen File, in dem der Bericht erstellt wird.

Parameter
reportDir	File: das Stammverzeichnis des Berichts.

Gibt Folgendes zurück:
File	eine Datei

Löst aus
	java.io.IOException
IOException

getTestName

protected String getTestName (TestIdentifier testId)

Parameter
testId	TestIdentifier

Gibt Folgendes zurück:
String

getTestSuiteName

protected String getTestSuiteName ()

Gibt Folgendes zurück:
String