Listener ILogSaver

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener


Consente a ITestInvocationListener di rilevare quando vengono salvati i file di log.

In questo modo più ITestInvocationListener possono utilizzare lo stesso file di log salvato quando generando report ed evita che ogni listener salvi il file singolarmente quando viene chiamato ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

Le classi che implementano questa interfaccia devono tenere presente che testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) viene chiamato ogni volta che viene chiamato ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

Questa classe passa anche l'istanza globale di ILogSaver in modo che i ITestInvocationListener possano salvare altri file nella stessa posizione.

Riepilogo

Metodi pubblici

default void logAssociation(String dataName, LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile.

default void setLogSaver(ILogSaver logSaver)

Imposta ILogSaver per consentire all'implementatore di salvare i file.

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

Richiamato quando il log di test viene salvato.

Metodi pubblici

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile. Pertanto, questo callback consente di fornire un'associazione in modo esplicito.

Parametri
dataName String: il nome dei dati

logFile LogFile: il valore LogFile registrato in precedenza e che deve essere associato al caso di test.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Imposta ILogSaver per consentire all'implementatore di salvare i file.

Parametri
logSaver ILogSaver: ILogSaver

TestLogSalvato

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

Richiamato quando il log di test viene salvato.

Da utilizzare al posto di ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

Parametri
dataName String: un nome descrittivo String dei dati. ad es. "device_logcat". Nota dataName non può essere univoco per ogni chiamata. ovvero gli implementer devono essere in grado di più chiamate con lo stesso dataName

dataType LogDataType: il LogDataType dei dati

dataStream InputStreamSource: il InputStreamSource dei dati. Gli addetti all'implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream al termine.

logFile LogFile: LogFile contenente i metadati del file salvato.