IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector


Diese Schnittstelle wird als Dekorator hinzugefügt, wenn Testergebnisse erfasst werden, um übereinstimmende Messwerte zu erfassen.

Diese Schnittstelle kann nicht als verwendet werden, auch wenn sie ITestInvocationListener erweitert. Die Konfigurationsprüfung lehnt sie ab. Es muss als „metrics_collector“ verwendet werden.

Für Collector-Objekte wird kein interner Status erwartet, da sie an mehreren Stellen wiederverwendet werden können. Wenn ein interner Status wirklich verwendet werden muss, sollte er bei init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) gelöscht werden.

Zusammenfassung

Öffentliche Methoden

default boolean captureModuleLevel()

Gibt an, ob der Collector für die Erfassung auf Modulebene verwendet werden kann und initialisiert werden soll.

abstract getBuildInfos()

Gibt die Liste der Build-Informationen zurück, die in der Aufrufanfrage verfügbar sind.

abstract getDevices()

Gibt die Liste der Geräte zurück, die bei der Aufrufung verfügbar sind.

abstract ITestInvocationListener getInvocationListener()

Gibt die ursprüngliche ITestInvocationListener zurück, an die die Ergebnisse weitergeleitet werden.

abstract ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

Initialisierung des Collectors mit dem aktuellen Kontext und der Information, wohin die Ergebnisse weitergeleitet werden sollen.

abstract void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

Rückruf, wenn ein Testfall mit einem Annahmefehler fehlschlägt.

abstract void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

Rückruf, wenn ein Testfall beendet ist.

abstract void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

Rückruf, wenn ein Testfall beendet ist.

abstract void onTestFail(DeviceMetricData testData, TestDescription test)

Rückruf, wenn ein Testlauf fehlschlägt.

default void onTestModuleEnded()

Ermöglicht das Erfassen des Ereignisses „Modulende“.

default void onTestModuleStarted()

Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.

abstract void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

Callback, wenn ein Testlauf beendet ist.

abstract void onTestRunStart(DeviceMetricData runData)

Callback, wenn ein Test gestartet wird.

default void onTestRunStart(DeviceMetricData runData, int testCount)

Callback, wenn ein Test gestartet wird.

abstract void onTestStart(DeviceMetricData testData)

Callback, wenn ein Testfall gestartet wird.

Öffentliche Methoden

captureModuleLevel

public boolean captureModuleLevel ()

Gibt an, ob der Collector für die Erfassung auf Modulebene verwendet werden kann und initialisiert werden soll.

Returns
boolean

getBuildInfos

public abstract  getBuildInfos ()

Gibt die Liste der Build-Informationen zurück, die in der Aufrufanfrage verfügbar sind.

Returns

getDevices

public abstract  getDevices ()

Gibt die Liste der Geräte zurück, die bei der Aufrufung verfügbar sind.

Returns

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Gibt die ursprüngliche ITestInvocationListener zurück, an die die Ergebnisse weitergeleitet werden.

Returns
ITestInvocationListener

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisierung des Collectors mit dem aktuellen Kontext und der Information, wohin die Ergebnisse weitergeleitet werden sollen. Wird nur einmal pro Instanz aufgerufen. Der Collector soll seinen internen Kontext und Listener aktualisieren. Init wird nie während eines Testlaufs aufgerufen, sondern immer davor.

Überschreiben Sie die Standardeinstellungen nur, wenn Sie wissen, was Sie tun.

Parameter
context IInvocationContext: den IInvocationContext für die laufende Aufrufabfolge.

listener ITestInvocationListener: die ITestInvocationListener, in der die Ergebnisse platziert werden sollen.

Returns
ITestInvocationListener der neue Listener umschließt den ursprünglichen.

Ausgabe
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Rückruf, wenn ein Testfall mit einem Annahmefehler fehlschlägt.

Parameter
testData DeviceMetricData: die DeviceMetricData, die die Daten für den Testfall enthält.

test TestDescription: die TestDescription des laufenden Testfalls.

Ausgabe
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Rückruf, wenn ein Testfall beendet ist. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
testData DeviceMetricData: die DeviceMetricData, die die Daten für den Testfall enthält. Dies ist dasselbe Objekt wie bei onTestStart(com.android.tradefed.device.metric.DeviceMetricData).

currentTestCaseMetrics : Die aktuelle Zuordnung von Messwerten, die an ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) übergeben werden.

test TestDescription: die TestDescription des laufenden Testfalls.

Ausgabe
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Rückruf, wenn ein Testfall beendet ist. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
testData DeviceMetricData: die DeviceMetricData, die die Daten für den Testfall enthält. Dies ist dasselbe Objekt wie bei onTestStart(com.android.tradefed.device.metric.DeviceMetricData).

currentTestCaseMetrics : Die aktuelle Zuordnung von Messwerten, die an ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) übergeben werden.

Ausgabe
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Rückruf, wenn ein Testlauf fehlschlägt.

Parameter
testData DeviceMetricData: die DeviceMetricData, die die Daten für den Testfall enthält.

test TestDescription: die TestDescription des laufenden Testfalls.

Ausgabe
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Ermöglicht das Erfassen des Ereignisses „Modulende“.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback, wenn ein Testlauf beendet ist. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
runData DeviceMetricData: die DeviceMetricData, die die Daten für den Lauf enthält. Dies ist dasselbe Objekt wie bei onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).

currentRunMetrics : Die aktuelle Zuordnung von Messwerten, die an ERROR(/#testRunEnded(long,Map)) übergeben werden.

Ausgabe
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback, wenn ein Test gestartet wird.

Parameter
runData DeviceMetricData: die DeviceMetricData, die die Daten für den Lauf enthält.

Ausgabe
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback, wenn ein Test gestartet wird.

Parameter
runData DeviceMetricData: die DeviceMetricData, die die Daten für den Lauf enthält.

testCount int: die Anzahl der Testfälle in diesem Testlauf.

Ausgabe
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback, wenn ein Testfall gestartet wird.

Parameter
testData DeviceMetricData: die DeviceMetricData, die die Daten für den Testfall enthält.

Ausgabe
DeviceNotAvailableException