ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Oggetto | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Il giornalista dei risultati crea un protobuf TestRecord
con tutti i risultati all'interno. Dovrebbe essere esteso per gestire cosa fare con il protocollo finale in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
Riepilogo
Costruttori pubblici | |
---|---|
ProtoResultReporter () |
Metodi pubblici | |
---|---|
final void | invocationEnded (long elapsedTime) Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore. |
void | invocationFailed ( FailureDescription failure) Segnala una chiamata incompleta a causa di una condizione di errore. |
void | invocationFailed (Throwable cause) Segnala una chiamata incompleta a causa di una condizione di errore. |
final void | invocationStarted ( IInvocationContext context) Segnala l'inizio della chiamata di test. |
final void | logAssociation (String dataName, LogFile logFile) In alcuni casi, log deve essere fortemente associato a un test case, ma l'opportunità di farlo direttamente |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Utilizzare il record di chiamata per inviare uno per uno tutti i log finali della chiamata. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) Gestione del proto finale con tutti i risultati. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Gestione del protocollo del record di test di chiamata parziale dopo che si è verificata |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Gestione del protocollo del record del caso di test finalizzato dopo che si è verificato |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Gestione del protocollo del record del caso di test parziale dopo che si è verificato |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Gestione del protocollo del record del modulo finalizzato dopo che si è verificato |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Gestione del protocollo del record del modulo parziale dopo che si è verificato |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Gestione del protocollo del record di esecuzione finalizzato dopo che si è verificato |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Gestione del proto record di esecuzione di test parziale dopo che si è verificato |
void | setGranularResults (boolean granularResults) |
void | setInlineRecordOfChildren (boolean inline) |
boolean | supportGranularResults () Restituisce True se il reporter supporta risultati granulari, false in caso contrario. |
final void | testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Riporta la fine dell'esecuzione di un singolo test case. |
final void | testFailed ( TestDescription test, FailureDescription failure) Segnala il fallimento di un singolo test case. |
final void | testFailed ( TestDescription test, String trace) Segnala il fallimento di un singolo test case. |
final void | testIgnored ( TestDescription test) Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore. |
final void | testModuleEnded () Segnala la fine dell'esecuzione di un modulo. |
final void | testModuleStarted ( IInvocationContext moduleContext) Segnala l'inizio di un modulo in esecuzione. |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Segnala la fine dell'esecuzione del test. |
final void | testRunFailed ( FailureDescription failure) L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da |
final void | testRunFailed (String errorMessage) L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione di prova. |
final void | testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di prova. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di prova. |
final void | testStarted ( TestDescription test, long startTime) Alternativa a |
final void | testStarted ( TestDescription test) Segnala l'inizio di un singolo test case. |
Metodi protetti | |
---|---|
TestRecordProto.ChildReference | createModuleChildReference (TestRecordProto.TestRecord record) Crea un riferimento figlio per un modulo. |
Costruttori pubblici
ProtoResultReporter
public ProtoResultReporter ()
Metodi pubblici
invocazioneEnded
public final void invocationEnded (long elapsedTime)
Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore.
Verrà richiamato automaticamente dal framework TradeFederation.Parametri | |
---|---|
elapsedTime | long : il tempo trascorso dell'invocazione in ms |
invocazione non riuscita
public void invocationFailed (FailureDescription failure)
Segnala una chiamata incompleta a causa di una condizione di errore.
Verrà richiamato automaticamente dal framework TradeFederation.
Parametri | |
---|---|
failure | FailureDescription : la FailureDescription che descrive la causa dell'errore |
invocazione non riuscita
public void invocationFailed (Throwable cause)
Segnala una chiamata incompleta a causa di una condizione di errore.
Verrà richiamato automaticamente dal framework TradeFederation.Parametri | |
---|---|
cause | Throwable : la causa ERROR(/Throwable) dell'errore |
invocazioneAvviato
public final void invocationStarted (IInvocationContext context)
Segnala l'inizio della chiamata di test.
Verrà richiamato automaticamente dal framework TradeFederation. I reporter devono ignorare questo metodo per supportare la segnalazione di più dispositivi.
Parametri | |
---|---|
context | IInvocationContext : informazioni sulla chiamata |
logAssociazione
public final void logAssociation (String dataName, LogFile logFile)
In alcuni casi, log deve essere fortemente associato a un test case, ma l'opportunità di farlo direttamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
la richiamata non è possibile. Pertanto, questo callback consente di fornire esplicitamente un'associazione forte.
Parametri | |
---|---|
dataName | String : il nome dei dati |
logFile | LogFile : il LogFile che è stato registrato in precedenza e deve essere associato al test case. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Utilizzare il record di chiamata per inviare uno per uno tutti i log finali della chiamata.
Parametri | |
---|---|
invocationLogs | TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta l'invocazione. |
processFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Gestione del proto finale con tutti i risultati.
Parametri | |
---|---|
finalRecord | TestRecordProto.TestRecord : il protocollo finalizzato con tutti i risultati della chiamata. |
processStartInvocazione
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Gestione del protocollo del record di test di chiamata parziale dopo che si è verificata invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parametri | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : il protocollo parziale popolato dopo l'invocationStart. |
invocationContext | IInvocationContext : la chiamata IInvocationContext . |
processTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Gestione del protocollo del record del caso di test finalizzato dopo che si è verificato ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
.
Parametri | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta un test case. |
processTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Gestione del protocollo del record del caso di test parziale dopo che si è verificato testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametri | |
---|---|
testCaseStartedRecord | TestRecordProto.TestRecord : il proto parziale che rappresenta il test case. |
processTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Gestione del protocollo del record del modulo finalizzato dopo che si è verificato testModuleEnded()
.
Parametri | |
---|---|
moduleRecord | TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta il modulo. |
processTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Gestione del protocollo del record del modulo parziale dopo che si è verificato testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parametri | |
---|---|
moduleStartRecord | TestRecordProto.TestRecord : il prototipo parziale che rappresenta il modulo. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Gestione del protocollo del record di esecuzione finalizzato dopo che si è verificato ERROR(/#testRunEnded(long,HashMap))
.
Parametri | |
---|---|
runRecord | TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta l'esecuzione. |
moduleInProgress | boolean : se un modulo è in corso o meno. |
processTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Gestione del proto record di esecuzione di test parziale dopo che si è verificato testRunStarted(String, int)
.
Parametri | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : il protocollo parziale che rappresenta l'esecuzione. |
setGranularResults
public void setGranularResults (boolean granularResults)
Parametri | |
---|---|
granularResults | boolean |
setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
Parametri | |
---|---|
inline | boolean |
supportGranularResults
public boolean supportGranularResults ()
Restituisce True se il reporter supporta risultati granulari, false in caso contrario.
ritorna | |
---|---|
boolean |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack dell'errore |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testTerminato
public final void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
dove possiamo specificare direttamente l'ora di fine. Combina con testStarted(com.android.tradefed.result.TestDescription, long)
per una misurazione accurata.
Parametri | |
---|---|
test | TestDescription : identifica il test |
endTime | long : l'ora in cui il test è terminato, misurato tramite ERROR(/System#currentTimeMillis()) |
testMetrics | ERROR(/Map) delle metriche emesse |
testTerminato
public void testEnded (TestDescription test,testMetrics)
Riporta la fine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, questo test ha avuto esito positivo. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del caso di test.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testMetrics | ERROR(/Map) delle metriche emesse |
testFailed
public final void testFailed (TestDescription test, FailureDescription failure)
Segnala il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testFailed
public final void testFailed (TestDescription test, String trace)
Segnala il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack dell'errore |
testIgnorato
public final void testIgnored (TestDescription test)
Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testModuleEnded
public final void testModuleEnded ()
Segnala la fine dell'esecuzione di un modulo.
testModuleAvviato
public final 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 una corsa che utilizza moduli: corridori basati su suite.
Parametri | |
---|---|
moduleContext | IInvocationContext : IInvocationContext del modulo. |
testRunEnded
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
Segnala la fine dell'esecuzione del test. FIXME: non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.
Parametri | |
---|---|
elapsedTimeMillis | long : tempo trascorso segnalato dal dispositivo, in millisecondi |
runMetrics | Metric . |
testRunFailed
public final void testRunFailed (FailureDescription failure)
L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da FailureDescription
.
Parametri | |
---|---|
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testRunFailed
public final void testRunFailed (String errorMessage)
L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile.
Parametri | |
---|---|
errorMessage | String : ERROR(/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 del test |
attemptNumber | int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ritentato in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero di tentativi è compreso tra 0 e 3. |
testRunStarted
public final 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 prova.
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 che vengono eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ritentato in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero di tentativi è compreso tra 0 e 3. |
startTime | long : l'ora in cui è iniziata la corsa, misurata tramite ERROR(/System#currentTimeMillis()) |
testAvviato
public final void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
dove specifichiamo anche quando il test è stato avviato, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
per una misura accurata .
Parametri | |
---|---|
test | TestDescription : identifica il test |
startTime | long : l'ora di inizio del test, misurata tramite ERROR(/System#currentTimeMillis()) |
testAvviato
public final void testStarted (TestDescription test)
Segnala l'inizio di un singolo test case. Interfaccia precedente, dovrebbe usare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test | TestDescription : identifica il test |
Metodi protetti
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Crea un riferimento figlio per un modulo.
Parametri | |
---|---|
record | TestRecordProto.TestRecord |
ritorna | |
---|---|
TestRecordProto.ChildReference |