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 ascoltatore proxy per tradurre i nomi del metodo di test, della classe e del pacchetto quando vengono generati 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 l'invocazione è terminata, con esito positivo 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)` Viene chiamato quando un test atomico segnala che presuppone 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 `TestSummary` che riassume l'esecuzione o null

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo 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`	: un `ERROR(/Map)` delle metriche emesse

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 implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine. Gli utenti che chiamano devono assicurarsi 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 registrate al termine di un'esecuzione del 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 del 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 test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription), se possibile.

Parametri
`test`	`TestDescription`: identifica il test

Metodi protetti

mangleTestId

protected 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)). 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 passa 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 esecuzione del test passati al callback testRunStarted(String, int). Il metodo deve restituire un nome di esecuzione del test eventualmente diverso che verrà passato al ITestInvocationListener a valle specificato durante la compilazione.

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`