ProtoResultReporter

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

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

Sottoclassi dirette note FileProtoResultReporter, StreamProtoResultReporter FileProtoResultReporter Reporter protocollo che scarica TestRecord in un file.  StreamProtoResultReporter Un'implementazione di ProtoResultReporter

---

Il reporter dei risultati crea un protobuf TestRecord con tutti i risultati all'interno. Deve 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) Report che la chiamata è stata terminata, correttamente o a causa di un errore .
void	invocationFailed(FailureDescription failure) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
void	invocationFailed(Throwable cause) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
void	invocationSkipped(SkipReason reason) Segnala una chiamata come saltata
final void	invocationStarted(IInvocationContext context) Segnala l'inizio della chiamata di test.
final void	logAssociation(String dataName, LogFile logFile) In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile.
void	processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs) Utilizza il record di chiamata per inviare uno alla volta tutti i log finali della chiamata.
void	processFinalProto(TestRecordProto.TestRecord finalRecord) Gestione del protocollo finale con tutti i risultati.
void	processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Gestione del protocollo del record del test di chiamata parziale dopo che si è verificato invocationStarted(com.android.tradefed.invoker.IInvocationContext).
void	processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord) Gestione del protocollo del record dello scenario di test finalizzato dopo il giorno ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).
void	processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord) Gestione del protocollo del record dello scenario 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 di modulo parziale dopo che si è verificato testModuleStarted(com.android.tradefed.invoker.IInvocationContext).
void	processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Gestione del protocollo del record dell'esecuzione finalizzata dopo il giorno ERROR(/#testRunEnded(long,HashMap)) si è verificato un errore.
void	processTestRunStarted(TestRecordProto.TestRecord runStartedRecord) Gestione del protocollo del record dell'esecuzione di test parziale dopo il giorno testRunStarted(String, int) si è verificato un errore.
void	setGranularResults(boolean granularResults)
void	setInlineRecordOfChildren(boolean inline)
boolean	supportGranularResults() Restituisce True se l'autore della segnalazione supporta risultati granulari, false negli altri casi.
final void	testAssumptionFailure(TestDescription test, String trace) Richiamato quando un test atomico segnala che assume una condizione falsa
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) Richiamato quando un test atomico segnala che assume una condizione falsa
final void	testEnded(TestDescription test, long endTime, testMetrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui è possibile specificare l'ora di fine strato Add.
void	testEnded(TestDescription test, testMetrics) Segnala la fine dell'esecuzione di un singolo scenario di test.
final void	testFailed(TestDescription test, FailureDescription failure) Segnala l'errore di un singolo scenario di test.
final void	testFailed(TestDescription test, String trace) Segnala l'errore di un singolo scenario di test.
final void	testIgnored(TestDescription test) Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora.
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) Fine dell'esecuzione del test nei report.
final void	testRunFailed(FailureDescription failure) L'esecuzione del test dei report non è riuscita a causa di un errore descritto da FailureDescription.
final void	testRunFailed(String errorMessage) 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.
final void	testRunStarted(String runName, int testCount) Segnala l'inizio di un'esecuzione di test.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di test.
final void	testSkipped(TestDescription test, SkipReason reason) Richiamato quando un test viene ignorato e non è stato 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 il test è stato iniziare, 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 scenario di test.

Metodi protetti
TestRecordProto.ChildReference	createModuleChildReference(TestRecordProto.TestRecord record) Crea un riferimento secondario per un modulo.

Costruttori pubblici

ProtoResultReporter

public ProtoResultReporter ()

Metodi pubblici

chiamata terminata

public final void invocationEnded (long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un errore .

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime	long: il tempo trascorso della chiamata in ms

chiamata non riuscita

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

chiamata non riuscita

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

chiamataIgnorata

public void invocationSkipped (SkipReason reason)

Segnala una chiamata come saltata

Parametri
reason	SkipReason

chiamataIniziata

public final void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override questo metodo per supportare la generazione di report su più dispositivi.

Parametri
context	IInvocationContext: informazioni sulla chiamata

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma la possibilità di farlo quindi sulla diretta testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile. Pertanto, questo callback consente di fornire un'associazione in modo esplicito.

Parametri
dataName	String: il nome dei dati
logFile	LogFile: il valore LogFile registrato in precedenza e che deve essere associato al caso di test.

processFinalInvocationLog

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilizza il record di chiamata per inviare uno alla volta tutti i log finali della chiamata.

Parametri
invocationLogs	TestRecordProto.TestRecord: il protocollo finalizzato che rappresenta la chiamata.

processoFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestione del protocollo finale con tutti i risultati.

Parametri
finalRecord	TestRecordProto.TestRecord: il protocollo finalizzato con tutti i risultati delle chiamate.

processStartInvocation

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

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

Parametri
invocationStartRecord	TestRecordProto.TestRecord: il protocollo parziale compilato dopo la chiamata all'inizio.
invocationContext	IInvocationContext: la chiamata IInvocationContext.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestione del protocollo del record dello scenario di test finalizzato dopo il giorno ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

Parametri
testCaseRecord	TestRecordProto.TestRecord: il protocollo finalizzato che rappresenta uno scenario di test.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Gestione del protocollo del record dello scenario di test parziale dopo che si è verificato testStarted(com.android.tradefed.result.TestDescription, long).

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

processoTestModuloFine

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.

processoTestModuloStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Gestione del protocollo del record di 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 dell'esecuzione finalizzata dopo il giorno ERROR(/#testRunEnded(long,HashMap)) si è verificato un errore.

Parametri
runRecord	TestRecordProto.TestRecord: il protocollo finalizzato che rappresenta l'esecuzione.
moduleInProgress	boolean: indica se un modulo è in corso o meno.

processiTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestione del protocollo del record dell'esecuzione di test parziale dopo il giorno testRunStarted(String, int) si è verificato un errore.

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

AssistenzaGranulari Risultati

public boolean supportGranularResults ()

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

Ritorni
boolean

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Richiamato quando un test atomico segnala che assume una condizione falsa

Parametri
test	TestDescription: identifica il test
trace	String: analisi dello stack degli errori

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Richiamato quando un test atomico segnala che assume 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)) in cui è possibile specificare l'ora di fine strato Add. 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	: una percentuale pari a ERROR(/Map) delle metriche emesse

testTerminato

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala la fine dell'esecuzione di un singolo scenario di test.

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi coppia chiave-valore metriche emesse durante l'esecuzione dello scenario di test.

Parametri
test	TestDescription: identifica il test
testMetrics	: una percentuale pari a ERROR(/Map) delle metriche emesse

testNon riuscito

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore di un singolo scenario di test.

Verrà chiamato tra testStarted e testEnded.

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

testNon riuscito

public final void testFailed (TestDescription test, 
                String trace)

Segnala l'errore di un singolo scenario di test.

Verrà chiamato tra testStarted e testEnded.

Parametri
test	TestDescription: identifica il test
trace	String: analisi dello stack degli errori

testIgnorato

public final void testIgnored (TestDescription test)

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

Parametri
test	TestDescription: identifica il test

testModuloTerminato

public final void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuloIniziato

public final void testModuleStarted (IInvocationContext moduleContext)

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

Parametri
moduleContext	IInvocationContext: il IInvocationContext del modulo.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Fine dell'esecuzione del test nei report. FIXME: Non possiamo avere due mappe<> si interfaccia con tipi diversi, dobbiamo usare HashMap qui.

Parametri
elapsedTimeMillis	long: tempo trascorso sul dispositivo segnalato, in millisecondi
runMetrics	: coppie chiave-valore segnalate al termine di un'esecuzione di test con Metric.

testRunNon riuscito

public final 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.

testRunNon riuscito

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String: 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 eseguite più volte. Il numero tentato è indicizzato a 0 e deve aumentare ogni volta quando si verifica una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 viene eseguito 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: 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: 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 eseguite più volte. Il numero di tentativi è indicizzato a 0 e deve aumentare ogni volta che una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 esecuzioni. sotto lo stesso runName e il numero tentato è compreso tra 0 e 3.
startTime	long: l'ora di inizio della corsa, misurata tramite System.currentTimeMillis()

testIgnorato

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. Si cercherà di ritentare questi test per ottenere un'esecuzione corretta.

Parametri
test	TestDescription: identifica il test
reason	SkipReason: SkipReason

testIniziato

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), dove specifichiamo anche quando il test è stato iniziare, 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 in cui è iniziato il test, misurata tramite System.currentTimeMillis()

testIniziato

public final void testStarted (TestDescription test)

Segnala l'inizio di un singolo scenario di test. Interfaccia precedente; dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
test	TestDescription: identifica il test

Metodi protetti

createModuleChildReference (CreaModuleChildReference)

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea un riferimento secondario per un modulo.

Parametri
record	TestRecordProto.TestRecord

Ritorni
TestRecordProto.ChildReference