Oyente de fragmentos

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Objeto
↳ com.android.tradefed.result.CollectingTestListener
↳ com.android.tradefed.invoker.ShardListener

Un ITestInvocationListener que recopila resultados de un fragmento de invocación (también conocido como una división de invocación para ejecutarse en varios recursos en paralelo) y los reenvía a otro oyente.

Resumen

Constructores públicos

ShardListener ( ITestInvocationListener main)

Crea un ShardListener .

Métodos públicos

getUnderlyingResultReporter ()
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

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 setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

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

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

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

void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

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 elapsedTime, runMetrics) testRunEnded (long elapsedTime, 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 failureMessage)

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

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

Informa del inicio de una ejecución de prueba.

Constructores públicos

Oyente de fragmentos

public ShardListener (ITestInvocationListener main)

Crea un ShardListener .

Parámetros
main ITestInvocationListener : ITestInvocationListener debe reenviar los resultados. Para evitar colisiones con otros ShardListener , este objeto se sincronizará en main al reenviar los resultados. Y los resultados solo se enviarán una vez que se complete el fragmento de invocación.

Métodos públicos

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Devoluciones

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ón omitida

public void invocationSkipped (SkipReason reason)

Informa una invocación como omitida

Parámetros
reason SkipReason

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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parámetros
enableGranularResults boolean

soporteGranularResultados

public boolean supportGranularResults ()

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

Devoluciones
boolean

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.

pruebaRegistroGuardado

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parámetros
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

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 elapsedTime, 
                 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
elapsedTime 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 failureMessage)

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

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

pruebaRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Informa del inicio de una ejecución de prueba.

Parámetros
name String : el nombre de la ejecución de prueba

numTests 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()