Questa pagina è stata tradotta dall'API Cloud Translation.

Listener di modulo

public class ModuleListener
extends CollectingTestListener

java.lang.Object
🎞	com.android.tradefed.result.CollectingTestListener
	🎞	com.android.tradefed.testtype.suite.ModuleListener

Listener associato a ogni IRemoteTest di ogni modulo per raccogliere l'elenco di che consentono di analizzare i dati e visualizzare i risultati.

Riepilogo

Costruttori pubblici
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Costruttore.

Metodi pubblici
`boolean`	`hasLastAttemptFailed()` Indica se l'ultimo tentativo del listener non è andato a buon fine.
`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.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Consente di impostare se il tentativo deve essere segnalato o meno come isolato.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Consente di stabilire se la raccolta dei dati è limitata o meno ai test.
`void`	`setMarkTestsSkipped(boolean skip)` Indica se contrassegnare o meno tutti gli scenari di test saltati.
`void`	`setTestMappingSources( testMappingSources)` Imposta le origini della mappatura dei test che verranno inserite nelle metriche.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Richiamato quando un test atomico segnala che assume una condizione falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Richiamato quando un test atomico segnala che assume una condizione falsa
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` in cui è possibile specificare l'ora di fine strato Add.
`void`	`testEnded(TestDescription test, testMetrics)` Segnala la fine dell'esecuzione di un singolo scenario di test.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'errore di un singolo scenario di test.
`void`	`testFailed(TestDescription test, String trace)` Segnala l'errore di un singolo scenario di test.
`void`	`testIgnored(TestDescription test)` Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, runMetrics)` Fine dell'esecuzione del test nei report.
`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 irreversibile.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Segnala l'inizio di un'esecuzione di test.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione di test.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto.
`void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, dove specifichiamo anche quando il test è stato iniziare, combinato con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` per una misurazione accurata.

Costruttori pubblici

Listener di modulo

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Costruttore.

Parametri
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Metodi pubblici

haUltimo tentativoNon riuscito

public boolean hasLastAttemptFailed ()

Indica se l'ultimo tentativo del listener non è andato a buon fine.

Ritorni
`boolean`

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.

setTentativoIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Consente di impostare se il tentativo deve essere segnalato o meno come isolato.

Parametri
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Consente di stabilire se la raccolta dei dati è limitata o meno ai test.

Parametri
`collectTestsOnly`	`boolean`

setMarkTestsSaltati

public void setMarkTestsSkipped (boolean skip)

Indica se contrassegnare o meno tutti gli scenari di test saltati.

Parametri
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Imposta le origini della mappatura dei test che verranno inserite nelle metriche.

Parametri
`testMappingSources`

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 degli errori

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.

testTerminato

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

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

Parametri
`test`	`TestDescription`: identifica il test
`endTime`	`long`: l'ora in cui è terminato il test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: una percentuale pari a `ERROR(/Map)` delle metriche emesse

testTerminato

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi coppia chiave-valore metriche emesse durante l'esecuzione dello scenario di test.

Parametri
`test`	`TestDescription`: identifica il test
`testMetrics`	: una percentuale pari a `ERROR(/Map)` delle metriche emesse

testNon riuscito

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore di un singolo scenario di test.

Verrà chiamato tra testStarted e testEnded.

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

testNon riuscito

public void testFailed (TestDescription test, 
                String trace)

Segnala l'errore di un singolo scenario di test.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`trace`	`String`: analisi dello stack degli errori

testIgnorato

public void testIgnored (TestDescription test)

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

Parametri
`test`	`TestDescription`: identifica il test

Diariotest

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

Parametri
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

TestLogSalvato

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

Parametri
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Fine dell'esecuzione del test nei report. FIXME: Non possiamo avere due mappe<> si interfaccia con tipi diversi, dobbiamo usare HashMap qui.

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

testRunNon riuscito

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 dell'esecuzione.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Segnala l'inizio di un'esecuzione di test.

Parametri
`name`	`String`: nome dell'esecuzione del test
`numTests`	`int`: numero totale di test nell'esecuzione del test
`attemptNumber`	`int`: numero d'ordine che identifica i diversi tentativi dello stesso runName che vengono eseguite più volte. Il numero tentato è indicizzato a 0 e deve aumentare ogni volta quando si verifica una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 viene eseguito con lo stesso runName e il numero di tentativi è compreso tra 0 e 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Segnala l'inizio di un'esecuzione di test.

Parametri
`name`	`String`: nome dell'esecuzione del test
`numTests`	`int`: numero totale di test nell'esecuzione del test
`attemptNumber`	`int`: numero d'ordine che identifica i diversi tentativi dello stesso runName che vengono eseguite più volte. Il numero di tentativi è indicizzato a 0 e deve aumentare ogni volta che una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 esecuzioni. sotto lo stesso runName e il numero tentato è compreso tra 0 e 3.
`startTime`	`long`: l'ora di inizio della corsa, misurata tramite `System.currentTimeMillis()`

testIgnorato

public void testSkipped (TestDescription test, 
                SkipReason reason)

Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. Si cercherà di ritentare questi test per ottenere un'esecuzione corretta.

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

testIniziato

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), dove specifichiamo anche quando il test è stato iniziare, 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 in cui è iniziato il test, misurata tramite `System.currentTimeMillis()`