SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Classi di sottoclasse dirette note LegacySubprocessResultsReporter LegacySubprocessResultsReporter Un'implementazione bloccata del report sui risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad es. 8 e versioni successive), nonostante le modifiche al superclasse.

---

Implementa ITestInvocationListener da specificare come result_reporter e inoltra dal subprocesso i risultati di test, esecuzioni di test e invocazioni 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, con esito positivo 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 un test case, ma non è possibile farlo nel callback diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
void	printEvent(String key, Object event) Funzione di supporto per stampare la chiave dell'evento e poi l'oggetto JSON.
void	setOutputTestLog(boolean outputTestLog) Imposta se è necessario o meno stampare 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 possiamo 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 test case.
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 fatale.
void	testRunStarted(String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione del 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) L'esecuzione del test dei report è stata 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, 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 (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 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

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 diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). 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 allo scenario di test.

printEvent

public void printEvent (String key, 
                Object event)

Funzione di supporto 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 il segnalatore supporta risultati granulari, false in caso contrario.

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. Combina con testStarted(com.android.tradefed.result.TestDescription, long) per una misurazione accurata.

Parametri
testId	TestDescription: identifica il test
endTime	long: l'ora di fine del test, misurata tramite System.currentTimeMillis()
metrics	: un 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 del test case.

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.

testFailed

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

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.

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza 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

testRunFailed

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

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione del test
attemptNumber	int: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti 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 del 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 del test.

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione del test
attemptNumber	int: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti 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.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunStopped

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)

Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. 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