ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener (in englischer Sprache)


Erlaubt ITestInvocationListeners, auf das Speichern von Protokolldateien zu warten.

So können mehrere ITestInvocationListeners dieselbe gespeicherte Logdatei verwenden, wenn Berichte generieren. Außerdem wird verhindert, dass die Datei beim ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)-Aufruf von jedem Listener einzeln gespeichert wird.

Klassen zur Implementierung dieser Schnittstelle sollten sich darüber im Klaren sein, dass testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) immer dann aufgerufen wird, wenn ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) aufgerufen wird.

Diese Klasse übergibt auch die globale ILogSaver-Instanz, sodass ITestInvocationListeners zusätzliche Dateien am selben Speicherort speichern können.

Zusammenfassung

Öffentliche Methoden

default void logAssociation(String dataName, LogFile logFile)

In einigen Fällen muss das Protokoll eng mit Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich.

default void setLogSaver(ILogSaver logSaver)

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

default void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

Wird beim Speichern des Testprotokolls aufgerufen.

Öffentliche Methoden

LogAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit Testfällen verknüpft sein, aber es besteht die Möglichkeit, also zum direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Callback ist nicht möglich. Dieser Callback ermöglicht also eine starke Assoziation explizit auf.

Parameter
dataName String: der Name der Daten

logFile LogFile: LogFile, die zuvor protokolliert wurde und mit dem Testfall.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

Parameter
logSaver ILogSaver: die ILogSaver

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Wird beim Speichern des Testprotokolls aufgerufen.

Sollte anstelle von ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) verwendet werden.

Parameter
dataName String: Ein beschreibender String-Name der Daten. z.B. „device_logcat“. Hinweis dataName darf pro Aufruf nicht eindeutig sein. d. h. Implementierungsteams müssen Mehrere Aufrufe mit demselben dataName

dataType LogDataType: die LogDataType der Daten

dataStream InputStreamSource: die InputStreamSource der Daten. Implementierungslösungen sollten createInputStream, um mit dem Lesen der Daten zu beginnen und sicherzustellen, dass das resultierende InputStream, wenn abgeschlossen ist.

logFile LogFile: LogFile mit den Metadaten der gespeicherten Datei