ProtoResultReportero

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

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


El reportero de resultados crea un protobuf TestRecord con todos los resultados dentro. Debería ampliarse para manejar qué hacer con el proto 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 finalizado, ya sea exitosamente 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.

void invocationSkipped ( SkipReason reason)

Informa una invocación como omitida

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 un caso de prueba, pero la oportunidad de hacerlo en el 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 a uno todos los logs 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 protocolo 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 se produjo ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Manejo del protocolo de registro de caso de prueba parcial después de que se produjo testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

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

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Manejo del protocolo de registro del 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 se produjera ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

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

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

Devuelve True si el reportero admite resultados granulares; false en caso contrario.

final void testAssumptionFailure ( TestDescription test, String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Se llama cuando una prueba atómica indica 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 el error de un caso de prueba individual.

final void testFailed ( TestDescription test, String trace)

Informa el error de un caso de prueba individual.

final void testIgnored ( TestDescription test)

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

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

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

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 prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

final void testRunFailed (String errorMessage)

La ejecución de 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 testSkipped ( TestDescription test, SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera.

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, combinado con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .

final void testStarted ( TestDescription test)

Informa el 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

ProtoResultReportero

public ProtoResultReporter ()

Métodos públicos

invocaciónFinalizada

public final void invocationEnded (long elapsedTime)

Informa que la invocación ha finalizado, ya sea exitosamente o debido a alguna condición de error.

Será llamado automáticamente por el marco de TradeFederation.

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

invocación fallida

public void invocationFailed (FailureDescription failure)

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

Será llamado automáticamente por el marco de TradeFederation.

Parámetros
failure FailureDescription : la FailureDescription que describe la causa del fallo.

invocación fallida

public void invocationFailed (Throwable cause)

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

Será llamado automáticamente por el marco de TradeFederation.

Parámetros
cause Throwable : la causa Throwable del fallo.

invocación omitida

public void invocationSkipped (SkipReason reason)

Informa una invocación como omitida

Parámetros
reason SkipReason

invocaciónIniciada

public final void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco de 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 registros

public final void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con un caso de prueba, pero la oportunidad de hacerlo en el 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 tanto, esta devolución de llamada permite proporcionar una asociación fuerte de forma explícita.

Parámetros
dataName String : El nombre de los datos.

logFile LogFile : el LogFile que se registró antes y que debe asociarse con el caso de prueba.

procesoFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilice el registro de invocación para enviar uno a uno todos los logs finales de la invocación.

Parámetros
invocationLogs TestRecordProto.TestRecord : el protocolo 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 protocolo finalizado con todos los resultados de la invocación.

procesoInicioInvocación

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

Manejo del protocolo 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 proto parcial completado después de invocationStart.

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 se produjo ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

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

procesoCasePruebaIniciado

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Manejo del protocolo de registro de caso de prueba parcial después de que se produjo testStarted(com.android.tradefed.result.TestDescription, long) .

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

procesoTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

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

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

procesoTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

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

Parámetros
moduleStartRecord TestRecordProto.TestRecord : el proto 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 se produjera ERROR(/#testRunEnded(long,HashMap)) .

Parámetros
runRecord TestRecordProto.TestRecord : el protocolo finalizado que representa la ejecución.

moduleInProgress boolean : si un módulo está en progreso o no.

procesoTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

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

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

setGranularResults

public void setGranularResults (boolean granularResults)

Parámetros
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parámetros
inline boolean

soporteGranularResultados

public boolean supportGranularResults ()

Devuelve True si el reportero admite resultados granulares; false en caso contrario.

Devoluciones
boolean

pruebaSuposiciónFracaso

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
test TestDescription : identifica la prueba.

trace String : seguimiento de pila del error

pruebaSuposiciónFracaso

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica indica 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.

pruebafinalizada

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 System.currentTimeMillis()

testMetrics : un ERROR(/Map) de las métricas emitidas

pruebafinalizada

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 pueda haberse 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 el error 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 el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription : identifica la prueba.

trace String : seguimiento de pila del error

pruebaIgnorado

public final void testIgnored (TestDescription test)

Se llama cuando no se va a 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 el final de la ejecución de un módulo.

módulo de prueba iniciado

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

pruebaRunEnded

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 diferentes tipos, por lo que tenemos que usar HashMap aquí.

Parámetros
elapsedTimeMillis long : tiempo transcurrido informado por el dispositivo, en milisegundos

runMetrics : pares clave-valor informados al final de una ejecución de prueba con Metric .

prueba de ejecución fallida

public final void testRunFailed (FailureDescription failure)

La ejecución de prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

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

prueba de ejecución fallida

public final void testRunFailed (String errorMessage)

La ejecución de 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.

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo el mismo nombre de ejecución y el número de intento es de 0 a 3.

pruebaRunStarted

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

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo 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 mediante System.currentTimeMillis()

prueba omitida

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. Se intentará volver a realizar estas pruebas para intentar obtener una ejecución adecuada.

Parámetros
test TestDescription : identifica la prueba.

reason SkipReason : SkipReason

pruebaIniciada

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, combinado 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()

pruebaIniciada

public final void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. La interfaz anterior debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription : identifica la prueba.

Métodos protegidos

crearModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crea una referencia secundaria para un módulo.

Parámetros
record TestRecordProto.TestRecord

Devoluciones
TestRecordProto.ChildReference