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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la richiamata non è possibile.

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

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

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

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Gestione del protocollo del record del modulo finalizzato dopo che si è verificato testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Gestione del protocollo del record del modulo parziale dopo che si è verificato testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Gestione del protocollo del record di esecuzione finalizzato dopo che si è verificato ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestione del proto record di esecuzione di test parziale dopo che si è verificato testRunStarted(String, int) .

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove possiamo specificare direttamente l'ora di fine.

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 FailureDescription .

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 testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata .

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 Throwable del fallimento

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 è terminato il test, misurato tramite System.currentTimeMillis()

testMetrics : un 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 : un 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 : coppie chiave-valore riportate al termine di un'esecuzione di test con 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 : 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 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.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

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

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 di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testAvviato

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata .

Parametri
test TestDescription : identifica il test

startTime long : l'ora di inizio del test, misurata tramite 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