Questa pagina è stata tradotta dall'API Cloud Translation.

ModuloListener

public class ModuleListener
extends CollectingTestListener

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

Listener collegato a ciascun IRemoteTest di ciascun modulo per raccogliere l'elenco dei risultati.

Riepilogo

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

Metodi pubblici
`boolean`	`hasLastAttemptFailed ()` Restituisce se l'ultima sessione di nuovi tentativi del listener ha avuto esito negativo.
`void`	`logAssociation (String dataName, LogFile logFile)` In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` la richiamata non è possibile.
`void`	`setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)` Imposta se il tentativo deve essere segnalato o meno come isolato.
`void`	`setCollectTestsOnly (boolean collectTestsOnly)` Imposta se stiamo raccogliendo o meno solo i test.
`void`	`setMarkTestsSkipped (boolean skip)` Se contrassegnare o meno tutti i casi di test saltati.
`void`	`setTestMappingSources ( testMappingSources)` `setTestMappingSources ( testMappingSources)` Imposta le origini della mappatura dei test che verranno inserite nei parametri.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` dove possiamo specificare direttamente l'ora di fine.
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Riporta la fine dell'esecuzione di un singolo test case.
`void`	`testFailed ( TestDescription test, FailureDescription failure)` Riporta il fallimento di un singolo test case.
`void`	`testFailed ( TestDescription test, String trace)` Riporta il fallimento di un singolo test case.
`void`	`testIgnored ( TestDescription test)` Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Segnala la fine dell'esecuzione del test.
`void`	`testRunFailed ( FailureDescription failure)` Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da `FailureDescription` .
`void`	`testRunFailed (String errorMessage)` Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile.
`void`	`testRunStarted (String name, int numTests, int attemptNumber)` Segnala l'inizio di un'esecuzione di prova.
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione di prova.
`void`	`testStarted ( TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` dove specifichiamo anche quando è stato avviato il test, combinato con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` per una misurazione accurata .

Costruttori pubblici

ModuloListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Costruttore.

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

Metodi pubblici

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Restituisce se l'ultima sessione di nuovi tentativi del listener ha avuto esito negativo.

ritorna
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la richiamata non è possibile. Pertanto, questo callback consente di fornire esplicitamente un'associazione forte.

Parametri
`dataName`	`String` : il nome dei dati
`logFile`	`LogFile` : il `LogFile` che è stato registrato in precedenza e che dovrebbe essere associato al test case.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Imposta se il tentativo deve essere segnalato o meno come isolato.

Parametri
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Imposta se stiamo raccogliendo o meno solo i test.

Parametri
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Se contrassegnare o meno tutti i casi di test saltati.

Parametri
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Imposta le origini della mappatura dei test che verranno inserite nei parametri.

Parametri
`testMappingSources`

testAssunzioneFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
`test`	`TestDescription` : identifica il test
`trace`	`String` : traccia dello stack di errore

testAssunzioneFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chiamato quando un test atomico segnala che presuppone 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)) dove 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 in cui è terminato il test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Riporta la fine dell'esecuzione di un singolo test case.

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, il test è stato superato. Restituisce inoltre qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.

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

prova non riuscita

public void testFailed (TestDescription test, 
                FailureDescription failure)

Riporta il fallimento 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.

prova non riuscita

public void testFailed (TestDescription test, 
                String trace)

Riporta il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription` : identifica il test
`trace`	`String` : traccia dello stack di errore

testIgnorato

public void testIgnored (TestDescription test)

Chiamato quando un test non verrà eseguito, generalmente 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)

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

testLogSaved

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)

Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
`elapsedTime`	`long` : il dispositivo ha riportato il tempo trascorso, in millisecondi
`runMetrics`	: coppie chiave-valore riportate al termine di un'esecuzione di test con `Metric` .

testRunFailed

public void testRunFailed (FailureDescription failure)

Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da FailureDescription .

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

testRunFailed

public void testRunFailed (String errorMessage)

Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile.

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
`name`	`String` : il nome dell'esecuzione del test
`numTests`	`int` : numero totale di test nell'esecuzione del test
`attemptNumber`	`int` : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3.

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
`name`	`String` : il nome dell'esecuzione del test
`numTests`	`int` : numero totale di test nell'esecuzione del test
`attemptNumber`	`int` : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3.
`startTime`	`long` : l'ora di inizio dell'esecuzione, misurata tramite `System.currentTimeMillis()`

testAvviato

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove 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()`