SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Sottoclassi dirette note LegacySubprocessResultsReporter LegacySubprocessResultsReporter Un'implementazione bloccata del reporter sui risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad es. 8+), nonostante le modifiche nella sua superclasse.

---

Implementa ITestInvocationListener in modo che venga specificato come result_reporter e inoltra dal subprocesso i risultati di test, esecuzioni di test e chiamate di test.

Riepilogo

Costruttori pubblici
SubprocessResultsReporter()

Metodi pubblici
void	close()
TestSummary	getSummary() Consente a InvocationListener di restituire un riepilogo.
void	invocationEnded(long elapsedTime) Segnala che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
void	invocationFailed(FailureDescription failure) Segnala un'invocazione incompleta 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	logAssociation(String dataName, LogFile logFile) In alcuni casi, il log deve essere strettamente associato a uno scenario di test, ma non è possibile farlo con il callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto.
void	printEvent(String key, Object event) Funzione di supporto per stampare la chiave dell'evento e poi l'oggetto JSON.
void	setOutputTestLog(boolean outputTestLog) Consente di stabilire se restituire o meno il test registrato.
boolean	supportGranularResults() Restituisce True se il segnalatore supporta risultati granulari, false in caso contrario.
void	testAssumptionFailure(TestDescription testId, String trace) Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
void	testAssumptionFailure(TestDescription testId, FailureDescription failure) Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
void	testEnded(TestDescription testId, long endTime, metrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), in cui è possibile specificare direttamente l'ora di fine.
void	testEnded(TestDescription testId, metrics) Segnala il termine dell'esecuzione di un singolo test case.
void	testFailed(TestDescription testId, FailureDescription failure) Segnala l'errore di un singolo scenario di test.
void	testFailed(TestDescription testId, String reason) Segnala l'errore di un singolo test case.
void	testIgnored(TestDescription testId) 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	testModuleEnded() Segnala la fine dell'esecuzione di un modulo.
void	testModuleStarted(IInvocationContext moduleContext) Segnala l'inizio dell'esecuzione di un modulo.
void	testRunEnded(long time, runMetrics) Segnala la fine dell'esecuzione del test.
void	testRunFailed(FailureDescription failure) L'esecuzione del test dei report non è riuscita a causa di un errore descritto da FailureDescription.
void	testRunFailed(String reason) L'esecuzione del test dei report non è riuscita a causa di un errore irreversibile.
void	testRunStarted(String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione di test.
void	testRunStarted(String runName, int testCount) Segnala l'inizio di un'esecuzione del test.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione del test.
void	testRunStopped(long arg0) Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.
void	testSkipped(TestDescription testId, SkipReason reason) Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
void	testStarted(TestDescription testId, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) in cui viene specificato anche quando è stato avviato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.
void	testStarted(TestDescription testId) Segnala l'inizio di un singolo test case.

Costruttori pubblici

SubprocessResultsReporter

public SubprocessResultsReporter ()

Metodi pubblici

chiudi

public void close ()

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, correttamente o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime	long: il tempo trascorso della chiamata in ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
failure	FailureDescription: il FailureDescription che descrive la causa dell'errore

invocationFailed

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

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 la generazione di report su più dispositivi.

Parametri
context	IInvocationContext: informazioni sull'invocazione

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere strettamente associato a un test case, ma non è possibile farlo nel callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) diretto. Pertanto, questo callback consente di fornire un'associazione forte in modo esplicito.

Parametri
dataName	String: il nome dei dati
logFile	LogFile: il LogFile registrato in precedenza e da associare al test case.

printEvent

public void printEvent (String key, 
                Object event)

Assistente per stampare la chiave dell'evento e poi l'oggetto json.

Parametri
key	String
event	Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Imposta se è necessario o meno stampare il test registrato.

Parametri
outputTestLog	boolean

supportGranularResults

public boolean supportGranularResults ()

Restituisce True se l'autore della segnalazione supporta risultati granulari, false negli altri casi.

Ritorni
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

testEnded

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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

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

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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 dello scenario di test.

Parametri
testId	TestDescription: identifica il test
metrics	: un ERROR(/Map) delle metriche emesse

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Segnala l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

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

testNon riuscito

public void testFailed (TestDescription testId, 
                String reason)

Segnala l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
testId	TestDescription: identifica il test
reason	String: analisi dello stack dell'errore

testIgnored

public void testIgnored (TestDescription testId)

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

Parametri
testId	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.

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.

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che impiega i moduli: runner basati su suite.

Parametri
moduleContext	IInvocationContext: il IInvocationContext del modulo.

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

Parametri
time	long: tempo trascorso segnalato dal dispositivo, in millisecondi
runMetrics	: coppie chiave-valore registrate al termine di un'esecuzione del test

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.

testRunFailed

public void testRunFailed (String reason)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione di test
attemptNumber	int: numero ordine che identifica i diversi tentativi eseguiti dallo stesso runName più volte. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione di test.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione di test
attemptNumber	int: numero ordine che identifica i diversi tentativi eseguiti dallo stesso runName più volte. Il valore attemptNumber è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome runName e il valore attemptNumber deve essere compreso tra 0 e 3.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunArrestato

public void testRunStopped (long arg0)

L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: currently unused, consider removing

Parametri
arg0	long: tempo trascorso segnalato dal dispositivo, in millisecondi

testSkipped

public void testSkipped (TestDescription testId, 
                SkipReason reason)

Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.

Parametri
testId	TestDescription: identifica il test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription testId, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) in cui viene specificato anche quando è stato avviato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.

Parametri
testId	TestDescription: identifica il test
startTime	long: l'ora di inizio del test, misurata tramite System.currentTimeMillis()

testStarted

public void testStarted (TestDescription testId)

Segnala l'inizio di un singolo test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription), se possibile.

Parametri
testId	TestDescription: identifica il test