Questa pagina è stata tradotta dall'API Cloud Translation.

Listener NameMangle

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)` Report che la chiamata è stata terminata, correttamente o a causa di un errore .
`void`	`invocationFailed(Throwable cause)` Segnala una chiamata incompleta a causa di alcune condizioni di errore.
`void`	`invocationStarted(IInvocationContext context)` Segnala l'inizio della chiamata di test.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Richiamato quando un test atomico segnala che assume una condizione falsa
`void`	`testEnded(TestDescription test, testMetrics)` Segnala la fine dell'esecuzione 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)` Fornisce i dati di log o di debug associati dalla chiamata di test.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Fine dell'esecuzione del test nei report.
`void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è riuscita a causa di un errore irreversibile.
`void`	`testRunStarted(String runName, int testCount)` Segnala l'inizio di un'esecuzione di test.
`void`	`testRunStopped(long elapsedTime)` Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.
`void`	`testStarted(TestDescription test)` Segnala l'inizio di un singolo scenario di test.

Metodi protetti
`TestDescription`	`mangleTestId(TestDescription test)` Questo metodo viene eseguito su tutti gli elementi `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 esecuzioni di test passati al Chiamata di `testRunStarted(String, int)`.

Costruttori pubblici

Listener NameMangle

public NameMangleListener (ITestInvocationListener listener)

Parametri
`listener`	`ITestInvocationListener`

Metodi pubblici

getRiepilogo

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
`TestSummary`	Un elemento `TestSummary` che riepiloga l'esecuzione oppure un valore null

chiamata terminata

public void invocationEnded (long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un errore .

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`elapsedTime`	`long`: il tempo trascorso della chiamata in ms

chiamata non riuscita

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

chiamataIniziata

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

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

Parametri
`context`	`IInvocationContext`: informazioni sulla chiamata

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

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, 
                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)

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

La chiamata deve essere effettuata prima di ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oppure ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log host e, se applicabile, il logcat del dispositivo.

Parametri
`dataName`	`String`: un nome descrittivo `String` dei dati. ad es. "device_logcat". Nota dataName non può essere univoco per ogni chiamata. ovvero gli implementer devono essere in grado di più chiamate con lo stesso dataName
`dataType`	`LogDataType`: il `LogDataType` dei dati
`dataStream`	`InputStreamSource`: il `InputStreamSource` dei dati. Gli addetti all'implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream al termine. I chiamanti devono garantire che l'origine dei dati rimanga e accessibile fino al completamento del metodo testLog.

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 (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 runName, 
                int testCount)

Segnala l'inizio di un'esecuzione di test.

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

testRunArrestato

public void testRunStopped (long elapsedTime)

Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.

DA FARE: attualmente inutilizzato, valuta la possibilità di rimuoverlo

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

testIniziato

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo scenario di test. 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 elementi 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 dovrebbe restituire un TestDescription potenzialmente diverso che verrà trasferito al ITestInvocationListener a valle specificato durante la costruzione.

L'implementazione deve fare attenzione a non modificare il file 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 Chiamata di testRunStarted(String, int). Il metodo dovrebbe restituire una risposta nome dell'esecuzione di test che verrà passato all'ITestInvocationListener downstream che è specificato durante la costruzione.

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

L'implementazione predefinita trasmette il nome dell'esecuzione di test in entrata senza modifiche.

Parametri
`name`	`String`

Ritorni
`String`