ProtoResultReporter

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

java.lang.Objeto
↳	com.android.tradefed.result.proto.ProtoResultReporter

Subclases directas conocidas FileProtoResultReporter , StreamProtoResultReporter FileProtoResultReporter Proto reportero que vuelca el TestRecord en un archivo. StreamProtoResultReporter Una implementación de ProtoResultReporter

---

El reportero de resultados construye un prototipo TestRecord con todos los resultados dentro. Debería extenderse para controlar qué hacer con el prototipo final en processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

Resumen

Constructores públicos
ProtoResultReporter ()

Métodos públicos
final void	invocationEnded (long elapsedTime) Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.
void	invocationFailed ( FailureDescription failure) Informa una invocación incompleta debido a alguna condición de error.
void	invocationFailed (Throwable cause) Informa una invocación incompleta debido a alguna condición de error.
final void	invocationStarted ( IInvocationContext context) Informa el inicio de la invocación de prueba.
final void	logAssociation (String dataName, LogFile logFile) En algunos casos, el registro debe estar fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la devolución de llamada no es posible.
void	processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Utilice el registro de invocación para enviar uno por uno todos los registros finales de la invocación.
void	processFinalProto (TestRecordProto.TestRecord finalRecord) Manejo del proto final con todos los resultados.
void	processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Manejo del prototipo de registro de prueba de invocación parcial después de que se produjo invocationStarted(com.android.tradefed.invoker.IInvocationContext) .
void	processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Manejo del protocolo de registro de caso de prueba finalizado después de que ocurrió ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .
void	processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Manejo del prototipo de registro de caso de prueba parcial después de que ocurrió testStarted(com.android.tradefed.result.TestDescription, long) .
void	processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Manejo del prototipo de registro del módulo finalizado después de que ocurrió testModuleEnded() .
void	processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Manejo del prototipo de registro de módulo parcial después de que ocurrió testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .
void	processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Manejo del protocolo de registro de ejecución finalizado después de que ocurrió ERROR(/#testRunEnded(long,HashMap)) .
void	processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Manejo del protocolo de registro de ejecución de prueba parcial después de que ocurrió testRunStarted(String, int) .
void	setGranularResults (boolean granularResults)
void	setInlineRecordOfChildren (boolean inline)
boolean	supportGranularResults () Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.
final void	testAssumptionFailure ( TestDescription test, String trace) Llamado cuando una prueba atómica marca que asume una condición que es falsa
final void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Llamado cuando una prueba atómica marca que asume una condición que es 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)) donde podemos especificar la hora de finalización directamente.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Informa el final de la ejecución de un caso de prueba individual.
final void	testFailed ( TestDescription test, FailureDescription failure) Informa de la falla de un caso de prueba individual.
final void	testFailed ( TestDescription test, String trace) Informa de la falla de un caso de prueba individual.
final void	testIgnored ( TestDescription test) Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
final void	testModuleEnded () Informa del final de la ejecución de un módulo.
final void	testModuleStarted ( IInvocationContext moduleContext) Informa el comienzo de un módulo en ejecución.
final void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Informa el final de la ejecución de la prueba.
final void	testRunFailed ( FailureDescription failure) La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .
final void	testRunFailed (String errorMessage) La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
void	testRunStarted (String runName, int testCount, int attemptNumber) Informa del inicio de una ejecución de prueba.
final void	testRunStarted (String runName, int testCount) Informa del inicio de una ejecución de prueba.
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Informa del inicio de una ejecución de prueba.
final void	testStarted ( TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .
final void	testStarted ( TestDescription test) Informa del inicio de un caso de prueba individual.

Métodos protegidos
TestRecordProto.ChildReference	createModuleChildReference (TestRecordProto.TestRecord record) Crea una referencia secundaria para un módulo.

Constructores públicos

ProtoResultReporter

public ProtoResultReporter ()

Métodos públicos

invocaciónTerminada

public final void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
elapsedTime	long : el tiempo transcurrido de la invocación en ms

invocaciónError

public void invocationFailed (FailureDescription failure)

Informa una invocación incompleta debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
failure	FailureDescription : la FailureDescription que describe la causa de la falla

invocaciónError

public void invocationFailed (Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
cause	Throwable : la causa Throwable de la falla

invocaciónEmpezó

public final void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco TradeFederation. Los reporteros deben anular este método para admitir informes de múltiples dispositivos.

Parámetros
context	IInvocationContext : información sobre la invocación

asociación de registro

public final void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la devolución de llamada no es posible. Por lo tanto, esta devolución de llamada permite proporcionar explícitamente una asociación fuerte.

Parámetros
dataName	String : el nombre de los datos
logFile	LogFile : el LogFile que se registró antes y debe asociarse con el caso de prueba.

procesoFinalInvocaciónRegistros

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilice el registro de invocación para enviar uno por uno todos los registros finales de la invocación.

Parámetros
invocationLogs	TestRecordProto.TestRecord : el prototipo finalizado que representa la invocación.

procesoFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Manejo del proto final con todos los resultados.

Parámetros
finalRecord	TestRecordProto.TestRecord : el prototipo finalizado con todos los resultados de la invocación.

procesoInicioInvocación

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

Manejo del prototipo de registro de prueba de invocación parcial después de que se produjo invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Parámetros
invocationStartRecord	TestRecordProto.TestRecord : el prototipo parcial rellenado después de la invocaciónStart.
invocationContext	IInvocationContext : La invocación IInvocationContext .

procesoTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Manejo del protocolo de registro de caso de prueba finalizado después de que ocurrió ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Parámetros
testCaseRecord	TestRecordProto.TestRecord : el prototipo finalizado que representa un caso de prueba.

procesoTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Manejo del prototipo de registro de caso de prueba parcial después de que ocurrió testStarted(com.android.tradefed.result.TestDescription, long) .

Parámetros
testCaseStartedRecord	TestRecordProto.TestRecord : el prototipo parcial que representa el caso de prueba.

ProcessTestModuleEndProcessTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Manejo del prototipo de registro del módulo finalizado después de que ocurrió testModuleEnded() .

Parámetros
moduleRecord	TestRecordProto.TestRecord : el prototipo finalizado que representa el módulo.

procesoTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Manejo del prototipo de registro de módulo parcial después de que ocurrió testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Parámetros
moduleStartRecord	TestRecordProto.TestRecord : el prototipo parcial que representa el módulo.

procesoTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Manejo del protocolo de registro de ejecución finalizado después de que ocurrió ERROR(/#testRunEnded(long,HashMap)) .

Parámetros
runRecord	TestRecordProto.TestRecord : el prototipo finalizado que representa la ejecución.
moduleInProgress	boolean : si un módulo está o no en progreso.

procesoTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Manejo del protocolo de registro de ejecución de prueba parcial después de que ocurrió testRunStarted(String, int) .

Parámetros
runStartedRecord	TestRecordProto.TestRecord : el prototipo parcial que representa la ejecución.

establecerResultados granulares

public void setGranularResults (boolean granularResults)

Parámetros
granularResults	boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parámetros
inline	boolean

supportGranularResults

public boolean supportGranularResults ()

Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.

Devoluciones
boolean

pruebaAsunciónFalla

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test	TestDescription : identifica la prueba
trace	String : rastro de pila de falla

pruebaAsunciónFalla

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test	TestDescription : identifica la prueba
failure	FailureDescription : FailureDescription que describe el error y su contexto.

pruebaTerminó

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente. Combínelo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medida precisa.

Parámetros
test	TestDescription : identifica la prueba
endTime	long : el tiempo que finalizó la prueba, medido a través de System.currentTimeMillis()
testMetrics	: un ERROR(/Map) de las métricas emitidas

pruebaTerminó

public void testEnded (TestDescription test, 
                 testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

Si no se invocó testFailed(TestDescription, FailureDescription) , esta prueba pasó. También devuelve cualquier métrica clave/valor que se haya emitido durante la ejecución del caso de prueba.

Parámetros
test	TestDescription : identifica la prueba
testMetrics	: un ERROR(/Map) de las métricas emitidas

prueba fallida

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test	TestDescription : identifica la prueba
failure	FailureDescription : FailureDescription que describe el error y su contexto.

prueba fallida

public final void testFailed (TestDescription test, 
                String trace)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test	TestDescription : identifica la prueba
trace	String : rastro de pila de falla

prueba ignorada

public final void testIgnored (TestDescription test)

Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
test	TestDescription : identifica la prueba

testModuleEnded

public final void testModuleEnded ()

Informa del final de la ejecución de un módulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Informa el comienzo de un módulo en ejecución. Esta devolución de llamada está asociada con testModuleEnded() y es opcional en la secuencia. Solo se usa durante una carrera que usa módulos: corredores basados ​​en suite.

Parámetros
moduleContext	IInvocationContext : el IInvocationContext del módulo.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: no podemos tener dos interfaces Map<> con un tipo diferente, por lo que tenemos que usar HashMap aquí.

Parámetros
elapsedTimeMillis	long : tiempo transcurrido informado por el dispositivo, en milisegundos
runMetrics	: pares clave-valor notificados al final de una ejecución de prueba con Metric .

pruebaRunFailed

public final void testRunFailed (FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

Parámetros
failure	FailureDescription : FailureDescription que describe el error y su contexto.

pruebaRunFailed

public final void testRunFailed (String errorMessage)

La ejecución de la prueba de informes no se pudo completar debido a un error fatal.

Parámetros
errorMessage	String : String que describe el motivo del error de ejecución.

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
runName	String : el nombre de la ejecución de prueba
testCount	int : número total de pruebas en ejecución de prueba
attemptNumber	int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Informa del inicio de una ejecución de prueba.

Parámetros
runName	String : el nombre de la ejecución de prueba
testCount	int : número total de pruebas en ejecución de prueba

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
runName	String : el nombre de la ejecución de prueba
testCount	int : número total de pruebas en ejecución de prueba
attemptNumber	int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.
startTime	long : la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis()

pruebaEmpezó

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .

Parámetros
test	TestDescription : identifica la prueba
startTime	long : la hora en que comenzó la prueba, medida a través de System.currentTimeMillis()

pruebaEmpezó

public final void testStarted (TestDescription test)

Informa del inicio de un caso de prueba individual. Interfaz anterior, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test	TestDescription : identifica la prueba

Métodos protegidos

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea una referencia secundaria para un módulo.

Parámetros
record	TestRecordProto.TestRecord

Devoluciones
TestRecordProto.ChildReference