Questa pagina è stata tradotta dall'API Cloud Translation.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Object
ꛭ	com.android.tradefed.result.NameMangleListener

Un listener proxy per tradurre nomi di metodi, classi e pacchetti di test quando vengono riportati i risultati.

Riepilogo

Costruttori pubblici
`NameMangleListener(ITestInvocationListener listener)`

Metodi pubblici
`TestSummary`	`getSummary()` Consente a InvocationListener di restituire un riepilogo.
`void`	`invocationEnded(long elapsedTime)` Segnala che la chiamata è stata terminata, correttamente o a causa di una condizione di errore.
`void`	`invocationFailed(Throwable cause)` Segnala un'invocazione incompleta a causa di una condizione di errore.
`void`	`invocationStarted(IInvocationContext context)` Segnala l'inizio dell'invocazione del test.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Richiamato quando un test atomico segnala che assume una condizione falsa
`void`	`testEnded(TestDescription test, testMetrics)` Segnala il termine dell'esecuzione 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`	`testRunEnded(long elapsedTime, runMetrics)` Segnala la fine dell'esecuzione del test.
`void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
`void`	`testRunStarted(String runName, int testCount)` 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`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo test case.

Metodi protetti
`TestDescription`	`mangleTestId(TestDescription test)` Questo metodo viene eseguito su tutti i `TestDescription` passati ai callback `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` e `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Questo metodo viene eseguito su tutti i nomi di esecuzione del test passati al callback `testRunStarted(String, int)`.

Costruttori pubblici

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametri
`listener`	`ITestInvocationListener`

Metodi pubblici

getSummary

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
`TestSummary`	Un elemento `TestSummary` che riassume l'esecuzione oppure un valore nullo

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

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Viene chiamato quando un test atomico segnala che presuppone una condizione falsa

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala il termine dell'esecuzione di un singolo test case.

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

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

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 dell'errore

testIgnored

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

testLog

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

Fornisce i dati di log o di debug associati dalla chiamata di test.

La chiamata deve essere effettuata prima di 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 implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine. I chiamanti devono garantire che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione del test.

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

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

testStarted

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo scenario di test. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
`test`	`TestDescription`: identifica il test

Metodi protetti

TestId mangle

protected TestDescription mangleTestId (TestDescription test)

Questo metodo viene eseguito su tutti gli oggetti TestDescription passati ai callback testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). Il metodo deve restituire un TestDescription possibilmente diverso che verrà passato al ITestInvocationListener a valle specificato durante la compilazione.

L'implementazione deve fare attenzione a non modificare l'TestDescription originale.

L'implementazione predefinita trasmette l'identificatore in arrivo senza modifiche.

Parametri
`test`	`TestDescription`

Ritorni
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Questo metodo viene eseguito su tutti i nomi di esecuzioni di test passati al callback testRunStarted(String, int). Il metodo deve restituire un nome dell'esecuzione di test potenzialmente diverso che verrà passato al ITestInvocationListener downstream specificato durante la costruzione.

L'implementazione deve fare attenzione a non modificare il nome dell'esecuzione originale.

L'implementazione predefinita passa il nome dell'esecuzione del test in arrivo senza modifiche.

Parametri
`name`	`String`

Ritorni
`String`