ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
com.android.tradefed.result.proto.ProtoResultReporter


Il reporter dei risultati crea un protocollo TestRecord con tutti i risultati all'interno. Dovrebbe essere esteso per gestire cosa fare con il proto finale in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

Riepilogo

Costruttori pubblici

ProtoResultReporter ()

Metodi pubblici

final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con successo o a causa di qualche condizione di errore.

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

Segnala un'invocazione come saltata

final void invocationStarted ( IInvocationContext context)

Riporta l'inizio dell'invocazione del test.

final void logAssociation (String dataName, LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul comando diretto 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)

Utilizza il record di invocazione per inviare uno per uno tutti i log finali dell'invocazione.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestione del prototipo finale con tutti i risultati.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Gestione del protocollo del record di test di invocazione parziale dopo che si è verificata invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestione del protocollo del record del test case finalizzato dopo che si è verificato ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Si è verificata la gestione del protocollo del record del test case parziale dopo 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 protocollo del record dell'esecuzione del 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 altrimenti.

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)

Riporta il fallimento di un singolo test case.

final void testFailed ( TestDescription test, String trace)

Riporta 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 dell'esecuzione di un modulo.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

Riporta la fine dell'esecuzione del test.

final void testRunFailed ( FailureDescription failure)

Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da FailureDescription .

final void testRunFailed (String errorMessage)

Impossibile completare l'esecuzione del test dei report 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 testSkipped ( TestDescription test, SkipReason reason)

Chiamato quando un test viene saltato e non viene eseguito per un motivo solitamente non previsto.

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)

Riporta l'inizio di un singolo caso di test.

Metodi protetti

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea un riferimento figlio per un modulo.

Costruttori pubblici

ProtoResultReporter

public ProtoResultReporter ()

Metodi pubblici

invocationEnded

public final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con successo o a causa di qualche condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime long : il tempo trascorso dell'invocazione in ms

invocazioneFailed

public void invocationFailed (FailureDescription failure)

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

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocazioneFailed

public void invocationFailed (Throwable cause)

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

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause Throwable : la causa Throwable del fallimento

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come saltata

Parametri
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

Riporta l'inizio dell'invocazione del test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono sovrascrivere questo metodo per supportare la segnalazione di più dispositivi.

Parametri
context IInvocationContext : informazioni sull'invocazione

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a un test case, ma l'opportunità di farlo sul comando diretto 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 che dovrebbe essere associato al test case.

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilizza il record di invocazione per inviare uno per uno tutti i log finali dell'invocazione.

Parametri
invocationLogs TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta l'invocazione.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestione del prototipo finale con tutti i risultati.

Parametri
finalRecord TestRecordProto.TestRecord : il protocollo finalizzato con tutti i risultati dell'invocazione.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Gestione del protocollo del record di test di invocazione parziale dopo che si è verificata invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Parametri
invocationStartRecord TestRecordProto.TestRecord : il protocollo parziale popolato dopo invocationStart.

invocationContext IInvocationContext : l'invocazione IInvocationContext .

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestione del protocollo del record del test case finalizzato dopo che si è verificato ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Parametri
testCaseRecord TestRecordProto.TestRecord : il protocollo finalizzato che rappresenta un caso di test.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Si è verificata la gestione del protocollo del record del test case parziale dopo testStarted(com.android.tradefed.result.TestDescription, long) .

Parametri
testCaseStartedRecord TestRecordProto.TestRecord : il protocollo parziale che rappresenta il caso di test.

processoTestModuleEnd

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 protocollo 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 la corsa.

moduleInProgress boolean : se un modulo è in corso o meno.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestione del protocollo del record dell'esecuzione del test parziale dopo che si è verificato testRunStarted(String, int) .

Parametri
runStartedRecord TestRecordProto.TestRecord : il protocollo parziale che rappresenta la corsa.

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

ritorna
boolean

testAssunzioneFailure

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 di errore

testAssunzioneFailure

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.

testEnded

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. Combinalo 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, misurata tramite System.currentTimeMillis()

testMetrics : un ERROR(/Map) delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Riporta la fine dell'esecuzione di un singolo test case.

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, il test è stato superato. Restituisce inoltre qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.

Parametri
test TestDescription : identifica il test

testMetrics : un ERROR(/Map) delle metriche emesse

prova non riuscita

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

prova non riuscita

public final void testFailed (TestDescription test, 
                String trace)

Riporta il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
test TestDescription : identifica il test

trace String : traccia dello stack di 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.

testModuleStarted

public final 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 una corsa che utilizza moduli: corridori basati su suite.

Parametri
moduleContext IInvocationContext : l' IInvocationContext del modulo.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Riporta la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
elapsedTimeMillis long : il dispositivo ha riportato il tempo trascorso, in millisecondi

runMetrics : coppie chiave-valore riportate al termine di un'esecuzione di test con Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

Impossibile completare l'esecuzione del test dei report 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)

Impossibile completare l'esecuzione del test dei report 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 dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è 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 dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3.

startTime long : l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testSaltato

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Chiamato quando un test viene saltato e non viene eseguito per un motivo solitamente non previsto. Si tenterà di ripetere questi test per tentare di ottenere una corretta esecuzione.

Parametri
test TestDescription : identifica il test

reason SkipReason : SkipReason

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)

Riporta l'inizio di un singolo caso di test. L'interfaccia precedente dovrebbe utilizzare 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