Questa pagina è stata tradotta dall'API Cloud Translation.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Classi di sottoclasse dirette note

FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer

FilteredResultForwarder	Variante di `ResultForwarder` che consente di segnalare solo una lista consentita di `TestDescription`.
JarHostTest.HostTestListener	Listener wrapper che inoltra tutti gli eventi tranne testRunStarted() e testRunEnded() all'ascoltatore incorporato.
LogSaverResultForwarder	Un `ResultForwarder` per salvare i log con il salvataggio file globale.
LogcatCrashResultForwarder	Ascoltatore speciale: in caso di errori (arresto anomalo del processo di ispezione) tenterà di estrarre dall'logcat l'arresto anomalo e lo aggiungerà al messaggio di errore associato al test.
PythonBinaryHostTest.PythonForwarder	Funzione di inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario.
ResultAndLogForwarder	Forwarder per i risultati e gli eventi dei log.
RetryResultForwarder	Un'estensione di `ResultForwarder` che esegue sempre il push a un determinato numero di tentativo.
ShardMainResultForwarder	Un `ResultForwarder` che combina i risultati delle invocazioni di test suddivise in parti.
TestTimeoutEnforcer	Listener che consentono di controllare il tempo di esecuzione di un determinato caso di test e di non riuscire se supera un determinato timeout.

Classi di sottoclasse indirette note

GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Helper di classe per rilevare l'inizio e la fine mancanti della corsa.
RetryLogSaverResultForwarder	Inoltra che gestisce anche il passaggio al tentativo corrente.

Un ITestInvocationListener che inoltra i risultati dell'invocazione a un elenco di altri ascoltatori.

Riepilogo

Costruttori pubblici
`ResultForwarder(ITestInvocationListener... listeners)` Costruttore dell'argomento variabile alternativo per `ResultForwarder`.
`ResultForwarder( listeners)` Crea un `ResultForwarder`.

Costruttori protetti
`ResultForwarder()` Crea un `ResultForwarder` con l'impostazione di listener differita.

Metodi pubblici
`TestSummary`	`getSummary()` Consente a InvocationListener di restituire un riepilogo.
`void`	`invocationEnded(long elapsedTime)` Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
`void`	`invocationFailed(FailureDescription failure)` Segnala una chiamata incompleta a causa di alcune condizioni di errore.
`void`	`invocationFailed(Throwable cause)` Segnala un'invocazione incompleta a causa di una condizione di errore.
`void`	`invocationSkipped(SkipReason reason)` Segnala una chiamata come saltata
`void`	`invocationStarted(IInvocationContext context)` Segnala l'inizio dell'invocazione del test.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, in cui è possibile specificare direttamente l'ora di fine.
`void`	`testEnded(TestDescription test, testMetrics)` Segnala il termine dell'esecuzione di un singolo test case.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'errore di un singolo test case.
`void`	`testFailed(TestDescription test, String trace)` Segnala l'errore di un singolo test case.
`void`	`testIgnored(TestDescription test)` Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornisce i dati di log o di debug associati dall'invocazione del test.
`void`	`testModuleEnded()` Segnala la fine dell'esecuzione di un modulo.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Segnala l'inizio dell'esecuzione di un modulo.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Segnala la fine dell'esecuzione del test.
`void`	`testRunFailed(FailureDescription failure)` L'esecuzione del test dei report non è riuscita a causa di un errore descritto da `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Segnala l'inizio di un'esecuzione di test.
`void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione di test.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione del test.
`void`	`testRunStopped(long elapsedTime)` L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
`void`	`testStarted(TestDescription test, long startTime)` In alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, in cui specifichiamo anche quando è stato avviato il test, combinato con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` per una misurazione accurata.
`void`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo test case.

Metodi protetti
	`getListeners()` Recupera l'elenco degli ascoltatori.
`void`	`setListeners(ITestInvocationListener... listeners)` Imposta gli ascoltatori dopo la compilazione.
`void`	`setListeners( listeners)` Imposta gli ascoltatori dopo la compilazione.

Costruttori pubblici

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Costruttore di arg variabile alternativo per ResultForwarder.

Parametri
`listeners`	`ITestInvocationListener`: i `ITestInvocationListener` reali a cui inoltrare i risultati

ResultForwarder

public ResultForwarder ( listeners)

Crea un ResultForwarder.

Parametri
`listeners`	: i `ITestInvocationListener` reali a cui inoltrare i risultati

Costruttori protetti

ResultForwarder

protected ResultForwarder ()

Crea un ResultForwarder con l'impostazione di listener differita. Destinato solo alle sottoclassi.

Metodi pubblici

getSummary

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
`TestSummary`	Un `TestSummary` che riassume l'esecuzione o null

chiamata terminata

public void invocationEnded (long elapsedTime)

Segnala che la chiamata è stata 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

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 una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

chiamataIgnorata

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

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

Parametri
`context`	`IInvocationContext`: informazioni sull'invocazione

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Richiamato quando un test atomico segnala che assume una condizione falsa

Parametri
`test`	`TestDescription`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Richiamato quando un test atomico segnala che assume una condizione falsa

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui possiamo specificare direttamente l'ora di fine. Combinalo con testStarted(com.android.tradefed.result.TestDescription, long) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`endTime`	`long`: l'ora di fine del test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala la fine dell'esecuzione di un singolo scenario di test.

Se testFailed(TestDescription, FailureDescription) non è stato invocato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione dello scenario di test.

Parametri
`test`	`TestDescription`: identifica il test
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Segnala l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testIgnored

public void testIgnored (TestDescription test)

Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.

Parametri
`test`	`TestDescription`: identifica il test

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.

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 strumenti di implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante al completamento. Gli utenti che chiamano devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testModuloTerminato

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza i moduli: runner basati su suite.

Parametri
`moduleContext`	`IInvocationContext`: il `IInvocationContext` del modulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

Parametri
`elapsedTime`	`long`: tempo trascorso sul dispositivo segnalato, in millisecondi
`runMetrics`	: coppie chiave/valore segnalate al termine dell'esecuzione di un test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita a causa di un errore descritto da FailureDescription.

Parametri
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testRunNon riuscito

public void testRunFailed (String errorMessage)

L'esecuzione del test dei report non è riuscita a causa di un errore irreversibile.

Parametri
`errorMessage`	`String`: `String` che descrive il motivo dell'errore di esecuzione.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione del test
`testCount`	`int`: numero totale di test nell'esecuzione di test
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione del test
`testCount`	`int`: numero totale di test nell'esecuzione di test

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione del test
`testCount`	`int`: numero totale di test nell'esecuzione di test
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il valore attemptNumber è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome runName e il valore attemptNumber deve essere compreso tra 0 e 3.
`startTime`	`long`: l'ora di inizio dell'esecuzione, misurata tramite `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: currently unused, consider removing

Parametri
`elapsedTime`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.

Parametri
`test`	`TestDescription`: identifica il test
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

In alternativa a testStarted(com.android.tradefed.result.TestDescription), in cui specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`startTime`	`long`: l'ora di inizio del test, misurata tramite `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription), se possibile.

Parametri
`test`	`TestDescription`: identifica il test

Metodi protetti

getListeners

protected  getListeners ()

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

Ritorni
	L'elenco di `ITestInvocationListener`.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Imposta gli ascoltatori dopo la compilazione. Destinato solo all'uso da parte di sottoclassi.

Parametri
`listeners`	`ITestInvocationListener`: i `ITestInvocationListener` reali a cui inoltrare i risultati

setListener

protected void setListeners ( listeners)

Imposta gli ascoltatori dopo la compilazione. Destinato solo all'uso da parte di sottoclassi.

Parametri
`listeners`	: i `ITestInvocationListener` reali a cui inoltrare i risultati