ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Objeto | |
↳ | com.android.tradefed.result.proto.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 |
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 |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Manejo del protocolo de registro de caso de prueba finalizado después de que ocurrió |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Manejo del prototipo de registro de caso de prueba parcial después de que ocurrió |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Manejo del prototipo de registro del módulo finalizado después de que ocurrió |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Manejo del prototipo de registro de módulo parcial después de que ocurrió |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Manejo del protocolo de registro de ejecución finalizado después de que ocurrió |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Manejo del protocolo de registro de ejecución de prueba parcial después de que ocurrió |
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 |
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 |
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 |
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 : el ERROR(/Throwable) causa 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 sólida.
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 : la hora en que finalizó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
testMetrics | 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 | 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 | 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 : ERROR(/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 ERROR(/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 ERROR(/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 |