BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

Objeto java.lang.
   ↳ com.android.tradefed.postprocessor.BasePostProcessor


El IPostProcessor base que debe extender cada implementación. Asegúrate de que la publicación de procesamiento de datos se llama antes que los generadores de informes de resultados finales.

Resumen

Constructores públicos

BasePostProcessor()

Métodos públicos

final ITestInvocationListener init(ITestInvocationListener listener)

Paso de inicialización del procesador posterior.

final void invocationEnded(long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

final void invocationFailed(FailureDescription failure)

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

final 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)

Objetos de escucha de invocación para reenvíos

final boolean isDisabled()

Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación).

final void logAssociation(String dataName, LogFile logFile)

En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) directo no es posible realizar la devolución de llamada.

Actualiza la asignación de registro a prueba.

processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)

Implementa este método para agregar métricas y registros en todas las pruebas.

abstract processRunMetricsAndLogs( rawMetrics, runLogs)

Implementa este método para generar un conjunto de métricas nuevas a partir de las métricas existentes y los registros del sistema operativo.

processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)

Implementa este método para el procesamiento posterior de las métricas y los registros de cada prueba.

final void setLogSaver(ILogSaver logSaver)

Establece ILogSaver para permitir que el implementador guarde archivos.

void setUp()

Anula este método en los procesadores posteriores para inicializar antes de que se ejecute la prueba.

final void testAssumptionFailure(TestDescription test, String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

Se llama cuando una prueba atómica marca que asume una condición falsa.

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

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

final void 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 ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

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

Usa este método para registrar un archivo de la implementación de PostProcessor.

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

Se llama cuando se guarda el registro de pruebas.

final void testModuleEnded()

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

final void testModuleStarted(IInvocationContext moduleContext)

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

final void testRunEnded(long elapsedTime, runMetrics)

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

final void testRunFailed(FailureDescription failure)

No se pudo completar la ejecución de prueba de los informes debido a un error que describe FailureDescription.

final void testRunFailed(String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

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

Informa el inicio de una ejecución de prueba.

final void testRunStarted(String runName, int testCount)

Devoluciones de llamada de ejecución de prueba

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

Informa el inicio de una ejecución de prueba.

final void testRunStopped(long elapsedTime)

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

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)

Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), donde también especificamos cuándo se realizó la prueba. comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para obtener una medición precisa.

final void testStarted(TestDescription test)

Devoluciones de llamada de casos de prueba

Métodos protegidos

void cleanUp()
MetricMeasurement.DataType getMetricType()

Anula este método para cambiar el tipo de métrica si es necesario.

String getRunName()

Constructores públicos

BasePostProcessor

public BasePostProcessor ()

Métodos públicos

init

public final ITestInvocationListener init (ITestInvocationListener listener)

Paso de inicialización del procesador posterior. Se debe llamar antes de cualquiera de las pruebas. devoluciones de llamada.

Parámetros
listener ITestInvocationListener

Muestra
ITestInvocationListener

invocaciónFinalizada

public final void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

Se llamará automáticamente a través del marco TradeFederation.

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

Error de invocación

public final void invocationFailed (FailureDescription failure)

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

Se llamará automáticamente a través del marco TradeFederation.

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

Error de invocación

public final void invocationFailed (Throwable cause)

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

Se llamará automáticamente a través del marco TradeFederation.

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

se omitió el proceso de invocación

public void invocationSkipped (SkipReason reason)

Informa una invocación como omitida

Parámetros
reason SkipReason

iniciación de invocación

public final void invocationStarted (IInvocationContext context)

Objetos de escucha de invocación para reenvíos

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

Inhabilitado

public final boolean isDisabled ()

Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). De lo contrario, el valor es falso.

Muestra
boolean

Asociación de registro

public final void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) directo no es posible realizar la devolución de llamada. Esta devolución de llamada permite proporcionar una asociación sólida de forma explícita.

Actualiza la asignación de registro a prueba. Si se llama a este método durante una prueba, el registro pertenece a la prueba; de lo contrario, será un registro de ejecución.

Parámetros
dataName String: Es el nombre de los datos.

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

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

Implementa este método para agregar métricas y registros en todas las pruebas. Métricas que provienen de este método se informará como métricas de ejecución. Solo las métricas recién generadas se deben y un nombre de clave único (no se permite ningún conflicto con las claves existentes).

Parámetros
allTestMetrics ListMultimap: Es un HashMultimap que almacena las métricas de cada prueba agrupadas por métrica. y nombres de usuario.

allTestLogs : Es un mapa en el que se almacena el mapa de cada prueba de archivos de registro protegidos por sus nombres de datos. usando el TestDescription de cada prueba como claves.

Muestra
El conjunto de métricas recién generadas de todas las métricas de prueba.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

Implementa este método para generar un conjunto de métricas nuevas a partir de las métricas existentes y los registros del sistema operativo. Solo se deben mostrar las métricas recién generadas y con un nombre de clave único (sin se permite la colisión con claves existentes).

Parámetros
rawMetrics : Es el conjunto de métricas sin procesar disponibles para la ejecución.

runLogs : Es el conjunto de archivos de registro de la ejecución de prueba.

Muestra
El conjunto de métricas recién generadas a partir de las métricas de ejecución.

procesoTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

Implementa este método para el procesamiento posterior de las métricas y los registros de cada prueba. Solo los nuevos las métricas generadas y con un nombre de clave único (sin colisión con los valores claves).

Parámetros
testDescription TestDescription: Es el objeto TestDescription que describe la prueba.

testMetrics : Es el conjunto de métricas de la prueba.

testLogs : Es el conjunto de archivos que se registró durante la prueba.

Muestra
El conjunto de métricas recién generadas a partir de las métricas de prueba.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Establece ILogSaver para permitir que el implementador guarde archivos.

Parámetros
logSaver ILogSaver: el ILogSaver

Configuración

public void setUp ()

Anula este método en los procesadores posteriores para inicializar antes de que se ejecute la prueba.

ErrordeAsuncióndeprueba

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

Parámetros
test TestDescription: Identifica la prueba.

trace String: seguimiento de pila de las fallas

ErrordeAsuncióndeprueba

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica marca que asume una condición falsa.

Parámetros
test TestDescription: Identifica la prueba.

failure FailureDescription: FailureDescription que describe la falla y su contexto

pruebaFinalizada

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener mediciones precisas.

Parámetros
test TestDescription: Identifica la prueba.

endTime long: La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis()

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

pruebaFinalizada

public final 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 se completó correctamente. También muestra cualquier par clave-valor. métricas que podrían haberse emitido durante la ejecución del caso de prueba.

Parámetros
test TestDescription: Identifica la prueba.

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

Prueba con errores

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 la falla y su contexto

Prueba con errores

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 de las fallas

pruebaIgnorada

public final void testIgnored (TestDescription test)

Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

Parámetros
test TestDescription: Identifica la prueba.

Registro de prueba

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

Usa este método para registrar un archivo de la implementación de PostProcessor.

Parámetros
dataName String: Es un nombre descriptivo String de los datos. p.ej., “device_logcat”. Nota dataName no puede ser único por invocación. es decir, los implementadores deben poder manejar varias llamadas con el mismo dataName

dataType LogDataType: el LogDataType de los datos

dataStream InputStreamSource: el InputStreamSource de los datos Los implementadores deben llamar createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream cuando se complete Los emisores deben asegurarse de que la fuente de los datos sea presente y accesible hasta que se complete el método testLog.

testLogSaved

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

Se llama cuando se guarda el registro de pruebas.

Debe usarse en lugar de ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

Parámetros
dataName String: Es un nombre descriptivo String de los datos. p.ej., “device_logcat”. Nota dataName no puede ser único por invocación. es decir, los implementadores deben poder manejar varias llamadas con el mismo dataName

dataType LogDataType: el LogDataType de los datos

dataStream InputStreamSource: el InputStreamSource de los datos Los implementadores deben llamar createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream cuando se complete

logFile LogFile: El LogFile que contiene los metadatos del archivo guardado.

módulodepruebafinalizado

public final void testModuleEnded ()

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

MódulodepruebaIniciado

public final void testModuleStarted (IInvocationContext moduleContext)

Informa el 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: ejecutores basados en paquetes.

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

pruebaRunfinalizada

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: No podemos tener dos mapas<> con diferentes tipos, por lo que aquí tenemos que usar HashMap.

Parámetros
elapsedTime long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.

runMetrics : Son pares clave-valor que se informan al final de una ejecución de prueba con Metric.

Error de ejecución de prueba

public final void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de los informes debido a un error que describe FailureDescription.

Parámetros
failure FailureDescription: FailureDescription que describe la falla y su contexto

Error de ejecución de prueba

public final void testRunFailed (String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

Parámetros
errorMessage String: String que describe el motivo de la falla de ejecución

pruebaRunStarted

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

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.

testCount int: Cantidad total de pruebas en la ejecución de prueba

attemptNumber int: Número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El valor de tryNumber tiene un índice 0 y debería aumentarse cada vez se ejecuta una nueva ejecución. p.ej., Se vuelve a intentar una prueba detallada 3 veces; debería tener 4 en total se ejecuta con el mismo runName y tryNumber del 0 al 3.

pruebaRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Devoluciones de llamada de ejecución de prueba

Parámetros
runName String: Es el nombre de la ejecución de prueba.

testCount int: Cantidad total de pruebas en la ejecución de prueba

pruebaRunStarted

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

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.

testCount int: Cantidad total de pruebas en la ejecución de prueba

attemptNumber int: Número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El valor de intentNumber tiene un índice 0 y debería aumentarse cada vez que se genera un una nueva carrera. p.ej., Se vuelve a intentar una prueba detallada 3 veces, por lo que debería tener 4 ejecuciones en total con el mismo runName e tryNumber del 0 al 3.

startTime long: Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis().

pruebaRundetenida

public final void testRunStopped (long elapsedTime)

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

PENDIENTE: Actualmente sin uso, te recomendamos que lo quites

Parámetros
elapsedTime long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.

pruebaOmitir

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 que se ejecute correctamente.

Parámetros
test TestDescription: Identifica la prueba.

reason SkipReason: SkipReason

Iniciodeprueba

public final void testStarted (TestDescription test, 
                long startTime)

Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), donde también especificamos cuándo se realizó la prueba. comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para obtener una medición precisa.

Parámetros
test TestDescription: Identifica la prueba.

startTime long: Es la hora en que comenzó la prueba, medida mediante System.currentTimeMillis().

Iniciodeprueba

public final void testStarted (TestDescription test)

Devoluciones de llamada de casos de prueba

Parámetros
test TestDescription: Identifica la prueba.

Métodos protegidos

Limpieza

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

Anula este método para cambiar el tipo de métrica si es necesario. De forma predeterminada, la métrica está configurada en el tipo de datos procesados.

Muestra
MetricMeasurement.DataType

getRunName

protected String getRunName ()

Muestra
String