SubprocesoResultadosReportero

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Objeto
↳ com.android.tradefed.result.SubprocessResultsReporter

Implementa ITestInvocationListener para especificarlo como result_reporter y reenviar desde el subproceso los resultados de las pruebas, ejecuciones de pruebas e invocaciones de pruebas.

Resumen

Constructores públicos

SubprocessResultsReporter ()

Métodos públicos

void close ()

TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

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 invocationStarted ( IInvocationContext context)

Informa el inicio de la invocación de prueba.

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 printEvent (String key, Object event)

Ayudante para imprimir la clave del evento y luego el objeto json.

void setOutputTestLog (boolean outputTestLog)

Establece si debemos generar la prueba registrada o no.

boolean supportGranularResults ()

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

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testAssumptionFailure ( TestDescription testId, FailureDescription failure)

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

void testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente.

void testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics)

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

void testFailed ( TestDescription testId, FailureDescription failure)

Informa el error de un caso de prueba individual.

void testFailed ( TestDescription testId, String reason)

Informa el error de un caso de prueba individual.

void testIgnored ( TestDescription testId)

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

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Proporciona los datos de registro o depuración asociados de la invocación de prueba.

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

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

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

Informa el final de la ejecución de la prueba.

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String reason)

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.

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.

void testRunStopped (long arg0)

La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.

void testSkipped ( TestDescription testId, SkipReason reason)

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

void testStarted ( TestDescription testId, 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 .

void testStarted ( TestDescription testId)

Informa el inicio de un caso de prueba individual.

Constructores públicos

SubprocesoResultadosReportero

public SubprocessResultsReporter ()

Métodos públicos

cerca

public void close ()

obtener resumen

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Devoluciones
TestSummary Un TestSummary que resume la ejecución, o nulo

invocaciónFinalizada

public 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ónIniciada

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

imprimirEvento

public void printEvent (String key, 
                Object event)

Ayudante para imprimir la clave del evento y luego el objeto json.

Parámetros
key String

event Object

establecerRegistro de prueba de salida

public void setOutputTestLog (boolean outputTestLog)

Establece si debemos generar la prueba registrada o no.

Parámetros
outputTestLog boolean

soporteGranularResultados

public boolean supportGranularResults ()

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

Devoluciones
boolean

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

Parámetros
testId TestDescription : identifica la prueba.

trace String : seguimiento de pila del error

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

Parámetros
testId TestDescription : identifica la prueba.

failure FailureDescription : FailureDescription que describe el error y su contexto.

pruebafinalizada

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
testId TestDescription : identifica la prueba.

endTime long : la hora en que finalizó la prueba, medida a través de System.currentTimeMillis()

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

pruebafinalizada

public void testEnded (TestDescription testId, 
                 metrics)

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
testId TestDescription : identifica la prueba.

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

prueba fallida

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
testId TestDescription : identifica la prueba.

failure FailureDescription : FailureDescription que describe el error y su contexto.

prueba fallida

public void testFailed (TestDescription testId, 
                String reason)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
testId TestDescription : identifica la prueba.

reason String : seguimiento de pila del error

pruebaIgnorado

public void testIgnored (TestDescription testId)

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
testId TestDescription : identifica la prueba.

registro de prueba

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Proporciona los datos de registro o depuración asociados de la invocación de prueba.

Debe llamarse antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

El marco de TradeFederation llamará automáticamente a este método, proporcionando el registro del host y, si corresponde, el logcat del dispositivo.

Parámetros
dataName String : una String que describe el nombre de los datos. por ejemplo, "device_logcat". Tenga en cuenta que dataName puede no ser único por invocación. es decir, los implementadores deben poder manejar múltiples llamadas con el mismo nombre de datos

dataType LogDataType : el LogDataType de los datos

dataStream InputStreamSource : el InputStreamSource de los datos. Los implementadores deben llamar a createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream resultante cuando esté completo. Las personas que llaman deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog.

testModuleEnded

public void testModuleEnded ()

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

módulo de prueba iniciado

public 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 void testRunEnded (long time, 
                 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
time 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 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 void testRunFailed (String reason)

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

Parámetros
reason 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 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()

pruebaEjecutarDetenido

public void testRunStopped (long arg0)

La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.

TODO: actualmente sin uso, considere eliminarlo

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

prueba omitida

public void testSkipped (TestDescription testId, 
                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
testId TestDescription : identifica la prueba.

reason SkipReason : SkipReason

pruebaIniciada

public void testStarted (TestDescription testId, 
                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
testId TestDescription : identifica la prueba.

startTime long : la hora en que comenzó la prueba, medida a través de System.currentTimeMillis()

pruebaIniciada

public void testStarted (TestDescription testId)

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
testId TestDescription : identifica la prueba.