NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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


Ein Proxy-Listener, der Testmethode, Klasse und Paketnamen bei der Berichterstellung übersetzt.

Zusammenfassung

Öffentliche Konstruktoren

NameMangleListener(ITestInvocationListener listener)

Öffentliche Methoden

TestSummary getSummary()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

void invocationEnded(long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

void invocationFailed(Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund einer Fehlerbedingung.

void invocationStarted(IInvocationContext context)

Gibt den Beginn der Testausführung an.

void testAssumptionFailure(TestDescription test, String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist

void testEnded(TestDescription test, testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

void testFailed(TestDescription test, String trace)

Meldet das Scheitern eines einzelnen Testlaufs.

void testIgnored(TestDescription test)

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

void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.

void testRunEnded(long elapsedTime, runMetrics)

Gibt das Ende des Testlaufs an.

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 Start eines Testlaufs.

void testRunStopped(long elapsedTime)

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

void testStarted(TestDescription test)

Gibt den Beginn eines einzelnen Testfalls an.

Geschützte Methoden

TestDescription mangleTestId(TestDescription test)

Diese Methode wird für alle TestDescription ausgeführt, die an die Rückrufe testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) und ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) übergeben werden.

String mangleTestRunName(String name)

Diese Methode wird für alle Namen von Testläufen ausgeführt, die an den testRunStarted(String, int)-Callback übergeben werden.

Öffentliche Konstruktoren

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parameter
listener ITestInvocationListener

Öffentliche Methoden

getSummary

public TestSummary getSummary ()

Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.

Returns
TestSummary Eine TestSummary, die den Lauf zusammenfasst, oder „null“

Aufrufende beendet

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, ob erfolgreich oder aufgrund einer Fehlerbedingung.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime long: die verstrichene Zeit seit der Aufrufung in ms

CallFailed (Aufruf fehlgeschlagen)

public void invocationFailed (Throwable cause)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
cause Throwable: die Throwable-Ursache des Fehlers

invocationStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, damit die Berichterstellung für mehrere Geräte unterstützt wird.

Parameter
context IInvocationContext: Informationen zur Aufrufung

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
test TestDescription: identifiziert den Test

trace String: Stacktrace des Fehlers

TestBeendet

public void testEnded (TestDescription test, 
                 testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Außerdem werden alle Schlüssel/Wert-Messwerte zurückgegeben, die während der Ausführung des Testfalls gesendet wurden.

Parameter
test TestDescription: Identifiziert den Test

testMetrics : ERROR(/Map) der gesendeten Messwerte

testFailed

public void testFailed (TestDescription test, 
                String trace)

Meldet das Scheitern eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test TestDescription: identifiziert den Test

trace String: Stack-Trace des Fehlers

testIgnored

public void testIgnored (TestDescription test)

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

Parameter
test TestDescription: identifiziert den Test

Test-Log

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.

Muss vor dem ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Hostprotokoll und gegebenenfalls das Geräte-Logcat bereit.

Parameter
dataName String: Ein String aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis: Der Datenname muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten.

dataType LogDataType: die LogDataType der Daten

dataStream InputStreamSource: die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss des Vorgangs schließen. Aufrufer sollten dafür sorgen, dass die Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Gibt das Ende des Testlaufs an.

Parameter
elapsedTime long: Gerät hat die verstrichene Zeit in Millisekunden gemeldet

runMetrics : Schlüssel/Wert-Paare, die am Ende eines Testlaufs gemeldet werden

testRunFailed

public void testRunFailed (String errorMessage)

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

Parameter
errorMessage String: String mit einer Beschreibung des Grunds für den Ausführungsfehler.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Gibt den Beginn eines Testlaufs an.

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 vorzeitig beendet.

TODO: currently unused, consider removing

Parameter
elapsedTime long: Vom Gerät gemeldete verstrichene Zeit in Millisekunden

testgestartet

public void testStarted (TestDescription test)

Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
test TestDescription: identifiziert den Test

Geschützte Methoden

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Diese Methode wird für alle TestDescription ausgeführt, die an die Rückrufe testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) und ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) übergeben werden. Die Methode sollte eine möglicherweise andere TestDescription zurückgeben, die an die nachgelagerte ITestInvocationListener übergeben wird, die während der Erstellung angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, die ursprüngliche TestDescription nicht zu ändern.

Bei der Standardimplementierung wird die eingehende Kennung unverändert übergeben.

Parameter
test TestDescription

Returns
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

Diese Methode wird für alle Namen von Testläufen ausgeführt, die an den testRunStarted(String, int)-Callback übergeben werden. Die Methode sollte einen möglicherweise anderen Namen für den Testlauf zurückgeben, der an die nachgelagerte ITestInvocationListener übergeben wird, die während der Erstellung angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, den ursprünglichen Ausführungsnamen nicht zu ändern.

Die Standardimplementierung übergibt den Namen des eingehenden Testlaufs unverändert.

Parameter
name String

Returns
String