ResultReporter

public class ResultReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
↳	com.google.android.tradefed.result.teststorage.ResultReporter

---

Zusammenfassung

Verschachtelte Klassen
class	ResultReporter.ListBuilder<T>

Konstanten
String	DEFAULT_BUILDPROVIDER
String	EXPERIMENTAL
String	SYSTEM_CHECKER
String	TRADEFED

Öffentliche Konstruktoren
ResultReporter()

Öffentliche Methoden
void	enableFilterProperty(boolean enableFilterProperty)
IConfiguration	getConfiguration()
TestSummary	getSummary() Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.
void	invocationEnded(long elapsedTime) Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.
void	invocationFailed(FailureDescription failure) Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
void	invocationFailed(Throwable cause) Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
void	invocationSkipped(SkipReason reason) Meldet einen Aufruf als übersprungen
void	invocationStarted(IInvocationContext context) Meldet den Beginn des Testaufrufs.
void	logAssociation(String dataName, LogFile log) In einigen Fällen muss ein Logeintrag stark mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback nicht.
void	putEarlySummary( summaries) Übergibt ein ERROR(/List) von TestSummarys, die nicht null sind und möglicherweise von ITestInvocationListeners zurückgegeben wurden, die als Teil der Konfiguration instanziiert wurden.
void	setConfiguration(IConfiguration configuration) Fügt die verwendete IConfiguration ein.
void	setLogSaver(ILogSaver logSaver) Legen Sie ILogSaver fest, damit der Implementierer Dateien speichern kann.
boolean	supportGranularResults() Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „False“.
void	testAssumptionFailure(TestDescription test, String trace) Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
void	testEnded(TestDescription test, long endTime, testMetrics) Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können.
void	testEnded(TestDescription test, metrics) Meldet das Ende der Ausführung eines einzelnen Testlaufs.
void	testFailed(TestDescription test, FailureDescription failure) Meldet das Fehlschlagen eines einzelnen Testlaufs.
void	testFailed(TestDescription test, String trace) Meldet das Fehlschlagen 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	testModuleEnded() Meldet das Ende einer Modulausführung.
void	testModuleStarted(IInvocationContext moduleContext) Meldet den Beginn der Ausführung eines Moduls.
void	testRunEnded(long elapsedTimeMillis, runMetrics) Meldet das Ende des Testlaufs.
void	testRunFailed(FailureDescription failure) Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, nicht abgeschlossen werden.
void	testRunFailed(String errorMessage) Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
void	testRunStarted(String runName, int testCount, int attemptNumber) Meldet den Beginn eines Testlaufs.
void	testRunStarted(String runName, int testCount) Meldet den Beginn eines Testlaufs.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Meldet den Beginn eines Testlaufs.
void	testSkipped(TestDescription test, SkipReason reason) Wird aufgerufen, wenn ein Test übersprungen wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde.
void	testStarted(TestDescription test, long startTime) Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung.
void	testStarted(TestDescription test) Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
ITestStorageClient	createTestStorageClient(IInvocationContext context)
String	getVersion()

Konstanten

DEFAULT_BUILDPROVIDER

public static final String DEFAULT_BUILDPROVIDER

Konstanter Wert: "androidbuild"

Experimental

public static final String EXPERIMENTAL

Konstanter Wert: "experimental"

SYSTEM_CHECKER

public static final String SYSTEM_CHECKER

Konstanter Wert: "system_checker"

TRADEFED

public static final String TRADEFED

Konstanter Wert: "tradefed"

Öffentliche Konstruktoren

ResultReporter

public ResultReporter ()

Öffentliche Methoden

enableFilterProperty

public void enableFilterProperty (boolean enableFilterProperty)

Parameter
enableFilterProperty	boolean

getConfiguration

public IConfiguration getConfiguration ()

Returns
IConfiguration

getSummary

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
elapsedTime	long: die verstrichene Zeit des Aufrufs in Millisekunden

invocationFailed

public void invocationFailed (FailureDescription failure)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
failure	FailureDescription: die FailureDescription, die die Ursache des Fehlers beschreibt

invocationFailed

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
cause	Throwable: die Throwable-Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

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

Parameter
context	IInvocationContext: Informationen zum Aufruf

logAssociation

public void logAssociation (String dataName, 
                LogFile log)

In einigen Fällen muss ein Logeintrag stark mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback nicht. Mit diesem Callback kann also explizit eine starke Assoziierung angegeben werden.

Parameter
dataName	String: Der Name der Daten
log	LogFile: die LogFile, die zuvor protokolliert wurde und dem Testlauf zugeordnet werden soll.

putEarlySummary

public void putEarlySummary ( summaries)

Übergibt ein ERROR(/List) von nicht leeren TestSummary-Objekten, die möglicherweise von ITestInvocationListener-Objekten zurückgegeben wurden, die als Teil der Konfiguration instanziiert wurden. Die ersten Zusammenfassungen werden nach ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) generiert und können am Ende des Aufrufs über ERROR(/#putSummary(List)) abgeschlossen werden.

Diese Funktion wird vor ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) aufgerufen und enthält alle Zusammenfassungen der Listener, die davor konfiguriert wurden.

Parameter
summaries	: Ein ERROR(/List) von TestSummarys, die nicht null sind, aus ITestInvocationListeners, die Teil der aktuellen Konfiguration sind.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
configuration	IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Legen Sie ILogSaver fest, damit der Implementierer Dateien speichern kann.

Parameter
logSaver	ILogSaver: die ILogSaver

supportGranularResults

public boolean supportGranularResults ()

Gibt „True“ zurück, wenn der Reporter detaillierte Ergebnisse unterstützt, andernfalls „False“.

Returns
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Parameter
test	TestDescription: Gibt den Test an.
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. Kombinieren Sie sie mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.

Parameter
test	TestDescription: Gibt den Test an.
endTime	long: Die Uhrzeit, zu der der Test beendet wurde, gemessen über System.currentTimeMillis()
testMetrics	: eine ERROR(/Map) der ausgegebenen Messwerte

testEnded

public void testEnded (TestDescription test, 
                 metrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) 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	TestDescription: Gibt den Test an.
metrics	: eine ERROR(/Map) der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test	TestDescription: Gibt den Test an.
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test	TestDescription: Gibt den Test an.
trace	String: Stacktrace 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: Gibt den Test an.

testModuleEnded

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls. Dieser Callback ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Runner.

Parameter
moduleContext	IInvocationContext: die IInvocationContext des Moduls.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Meldet das Ende des Testlaufs.

Parameter
elapsedTimeMillis	long: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
runMetrics	: Schlüssel/Wert-Paare, die am Ende eines Testlaufs gemeldet werden

testRunFailed

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, nicht abgeschlossen werden.

Parameter
failure	FailureDescription: FailureDescription, die den Fehler und seinen Kontext beschreibt.

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 testCount, 
                int attemptNumber)

Meldet den Beginn eines Testlaufs.

Parameter
runName	String: der Name des Testlaufs
testCount	int: Gesamtzahl der Tests im Testlauf
attemptNumber	int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Meldet den Beginn eines Testlaufs.

Parameter
runName	String: der Name des Testlaufs
testCount	int: Gesamtzahl der Tests im Testlauf
attemptNumber	int: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Beispiel: Ein Test wird dreimal wiederholt. Er sollte insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.
startTime	long: Die Startzeit des Laufs, gemessen mit System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde. Diese Tests werden wiederholt, um eine ordnungsgemäße Ausführung zu erreichen.

Parameter
test	TestDescription: Gibt den Test an.
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung.

Parameter
test	TestDescription: Gibt den Test an.
startTime	long: Die Uhrzeit, zu der der Test begonnen hat, gemessen über System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
test	TestDescription: Gibt den Test an.

Geschützte Methoden

createTestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

Parameter
context	IInvocationContext

Returns
ITestStorageClient

getVersion

protected String getVersion ()

Returns
String