LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

Classi di sottoclasse dirette note RetryLogSaverResultForwarder RetryLogSaverResultForwarder Inoltra che gestisce anche il passaggio al tentativo corrente.

---

Un ResultForwarder per salvare i log con il salvataggio file globale.

Riepilogo

Costruttori pubblici
LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)
LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config, boolean setLogSaver)

Metodi pubblici
void	invocationEnded(long elapsedTime) Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.
void	invocationStarted(IInvocationContext context) Segnala l'inizio dell'invocazione del test.
void	logAssociation(String dataName, LogFile logFile) In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto.
static void	logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type) Registra un file finale prima del completamento
static void	reportEndHostLog( listeners, ILogSaver saver, String name) Report host_log dalla sessione in corso.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Fornisce i dati di log o di debug associati dall'invocazione del test. Inoltre, salva il file di log con ILogSaver globale e chiama ILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) per gli ascoltatori che implementano l'interfaccia ILogSaverListener.
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) Inoltra solo testLog anziché salvare prima il log.
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Viene chiamato quando il log del test viene salvato. Se LogSaverResultForwarder è racchiuso in un altro, assicurati di inoltrare il callback testLogSaved agli ascoltatori sottostanti.

Costruttori pubblici

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

Parametri
logSaver	ILogSaver
listeners
config	IConfiguration

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config, 
                boolean setLogSaver)

Parametri
logSaver	ILogSaver
listeners
config	IConfiguration
setLogSaver	boolean

Metodi pubblici

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime	long: il tempo trascorso dall'invocazione in ms

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare i report su più dispositivi.

Parametri
context	IInvocationContext: informazioni sull'invocazione

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto. Pertanto, questo callback consente di fornire un'associazione forte in modo esplicito.

Parametri
dataName	String: il nome dei dati
logFile	LogFile: il LogFile registrato in precedenza e da associare allo scenario di test.

logFile

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

Registra un file finale prima del completamento

Parametri
listeners
saver	ILogSaver
source	InputStreamSource
name	String
type	LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

Report host_log dalla sessione in corso.

Parametri
listeners
saver	ILogSaver
name	String

testLog

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

Fornisce i dati di log o di debug associati dall'invocazione del test.

Deve essere chiamato prima del giorno ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log dell'host e, se applicabile, il logcat del dispositivo.

Inoltre, salva il file di log con ILogSaver globale e chiama ILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) per gli ascoltatori che implementano l'interfaccia ILogSaverListener.

Parametri
dataName	String: un nome descrittivo String dei dati, ad esempio "device_logcat". Nota: dataName potrebbe non essere univoco per ogni chiamata. Ad esempio, gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName
dataType	LogDataType: il LogDataType dei dati
dataStream	InputStreamSource: il InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine. Gli utenti che chiamano devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testLogForward

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

Inoltra solo testLog anziché salvare prima il log.

Parametri
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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

Viene chiamato quando il log del test viene salvato.

Deve essere utilizzato al posto di ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

Se LogSaverResultForwarder è racchiuso in un altro, assicurati di inoltrare il callback testLogSaved agli ascoltatori sottostanti.

Parametri
dataName	String: un nome descrittivo String dei dati, ad esempio "device_logcat". Nota: il nome dataName potrebbe non essere univoco per ogni chiamata. Ad esempio, gli implementatori devono essere in grado di gestire più chiamate con lo stesso nome dataName
dataType	LogDataType: il LogDataType dei dati
dataStream	InputStreamSource: il InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine.
logFile	LogFile: il LogFile contenente i metadati del file salvato.