Questa pagina è stata tradotta dall'API Cloud Translation.

ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

Un ResultForwarder che combina i risultati di invocazioni di test suddivise in parti. Segnala il completamento dell'invocazione agli ascoltatori solo al termine di tutte le invocazioni suddivise in parti.

Questa classe non è sicura per i thread. È previsto che i client si blocchino su questa classe quando inviano i risultati del test per impedire che i callback di chiamata vengano chiamati fuori sequenza.

Riepilogo

Costruttori pubblici
`ShardMainResultForwarder( listeners, int expectedShards)` Crea un `ShardMainResultForwarder`.

Metodi pubblici
	`getListeners()` Recupera l'elenco degli ascoltatori.
`void`	`invocationEnded(long elapsedTime)` Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
`void`	`invocationEnded(long elapsedTime, IInvocationContext context)` Callback più dettagliato per distinguere quale shard è stato completato.
`void`	`invocationFailed(FailureDescription failure)` Segnala un'invocazione incompleta a causa di una condizione di errore.
`void`	`invocationFailed(Throwable cause)` Segnala un'invocazione incompleta a causa di una condizione di errore.
`void`	`invocationSkipped(SkipReason reason)` Segnala un'invocazione come ignorata
`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.
`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.

Costruttori pubblici

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Crea un ShardMainResultForwarder.

Parametri
`listeners`	: l'elenco di `ITestInvocationListener` a cui inoltrare i risultati al termine di tutti gli shard
`expectedShards`	`int`: il numero di shard

Metodi pubblici

getListeners

public  getListeners ()

Recupera l'elenco degli ascoltatori. Destinato solo all'uso da parte di sottoclassi.

Ritorni
	L'elenco di `ITestInvocationListener`.

invocationEnded

public void invocationEnded (long elapsedTime)

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

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Callback più dettagliato per distinguere quale shard è stato completato.

Parametri
`elapsedTime`	`long`
`context`	`IInvocationContext`

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`failure`	`FailureDescription`: il `FailureDescription` che descrive la causa dell'errore

invocationFailed

public void invocationFailed (Throwable cause)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`cause`	`Throwable`: la causa `Throwable` dell'errore

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
`reason`	`SkipReason`

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 al test case.

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).

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.