Recopilación de prueba de escucha

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener , IDisableable

java.lang.Objeto
com.android.tradefed.result.CollectingTestListener


Un ITestInvocationListener que recopilará todos los resultados de las pruebas.

Aunque las estructuras de datos utilizadas en este objeto son seguras para subprocesos, las devoluciones de llamada ITestInvocationListener deben llamarse en el orden correcto.

Resumen

Constructores públicos

CollectingTestListener ()

Métodos públicos

IBuildInfo getBuildInfo ()

Este método está en desuso. confíe en IBuildInfo de getInvocationContext() .

TestRunResult getCurrentRunResults ()

Obtiene los resultados de la ejecución de prueba actual.

int getExpectedTests ()

Devuelve el número de pruebas esperadas.

IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación que se informó mediante invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

Devuelve la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

IInvocationContext getModuleContextForRunResult (String testRunName)

Devuelve el IInvocationContext del módulo asociado con los resultados.

MultiMap <String, LogFile > getModuleLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados asociados con el módulo.

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados no asociados con una ejecución de prueba o un módulo.

int getNumAllFailedTestRuns ()

Devuelve el número total de ejecuciones de prueba en estado de error.

int getNumAllFailedTests ()

Devuelve el número total de pruebas en un estado de error (solo las pruebas fallidas, las supuestas fallas no cuentan para ello).

int getNumTestsInState ( TestStatus status)

Devuelve el número de pruebas en un estado determinado para esta ejecución.

int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Para compatibilidad con tipos de estado anteriores

int getNumTotalTests ()

Devuelve el número total de pruebas completas para todas las ejecuciones.

IBuildInfo getPrimaryBuildInfo ()

Devuelve la información de compilación principal que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

Este método está en desuso. Utilice getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Devuelve TestRunResult para un solo intento.

int getTestRunAttemptCount (String testRunName)

Devuelve el número de intentos para un nombre de ejecución de prueba determinado.

getTestRunAttempts (String testRunName)

Obtiene todos los intentos de TestRunResult de una ejecución de prueba determinada.

getTestRunForAttempts (int attempt)

Obtiene todos los resultados de un intento determinado.

getTestRunNames ()

Devuelve todos los nombres de todas las ejecuciones de prueba.

boolean hasFailedTests ()

Devuelve si la invocación tuvo alguna prueba fallida o suposición fallida.

boolean hasTestRunResultsForName (String testRunName)

Devuelve si un nombre de ejecución de prueba determinado tiene algún resultado.

void invocationEnded (long elapsedTime)

Informa que la invocación ha finalizado, ya sea exitosamente o 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.

boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita la configuración y el desmontaje).

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 setBuildInfo ( IBuildInfo buildInfo)

Este método está en desuso. Ya no es necesario realizar pruebas.

void setDisable (boolean isDisabled)

Establece si el objeto debe deshabilitarse.

void setMergeStrategy ( MergeStrategy strategy)

Establece la MergeStrategy que se utilizará al fusionar resultados.

void testAssumptionFailure ( TestDescription test, String trace)

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

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

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.

void testFailed ( TestDescription test, FailureDescription failure)

Informa el error de un caso de prueba individual.

void testFailed ( TestDescription test, String trace)

Informa el error de un caso de prueba individual.

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.

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

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

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

Informa del inicio de una ejecución de prueba.

void testRunStarted (String name, int numTests)

Informa del inicio de una ejecución de prueba.

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

Informa del inicio de una ejecución de prueba.

void testRunStopped (long elapsedTime)

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

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.

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 .

void testStarted ( TestDescription test)

Informa el inicio de un caso de prueba individual.

Métodos protegidos

final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo por lo que evitamos llevarlos demasiado tiempo.

final void clearResultsForName (String testRunName)

Permite borrar los resultados de un nombre de ejecución determinado.

void setIsAggregrateMetrics (boolean aggregate)

Alternar la opción 'métricas agregadas'

Constructores públicos

Recopilación de prueba de escucha

public CollectingTestListener ()

Métodos públicos

obtener información de compilación

public IBuildInfo getBuildInfo ()

Este método está en desuso.
confíe en IBuildInfo de getInvocationContext() .

Devuelve la información de compilación.

Devoluciones
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Obtiene los resultados de la ejecución de prueba actual.

Tenga en cuenta que es posible que los resultados no estén completos. Se recomienda probar el valor de TestRunResult.isRunComplete() y/o (@link TestRunResult#isRunFailure()} según corresponda antes de procesar los resultados.

Devoluciones
TestRunResult TestRunResult que representa los datos recopilados durante la última ejecución de prueba

obtener pruebas esperadas

public int getExpectedTests ()

Devuelve el número de pruebas esperadas. Podría diferir de getNumTotalTests() si algunas pruebas no se ejecutaron.

Devoluciones
int

obtener contexto de invocación

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación que se informó mediante invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Devoluciones
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

Devuelve la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

Si hay varios resultados, cada ejecución de prueba se fusiona y el último resultado de la prueba sobrescribe los resultados de las ejecuciones anteriores. Las ejecuciones de prueba se ordenan por número de intento.

Las métricas para el mismo intento se fusionarán según la preferencia establecida por aggregate-metrics . Las métricas finales serán las métricas del último intento.

Devoluciones

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Devuelve el IInvocationContext del módulo asociado con los resultados.

Parámetros
testRunName String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
IInvocationContext El IInvocationContext del módulo para un nombre de ejecución de prueba determinado null si no hay resultados para ese nombre.

obtener archivos de registro de módulo

public MultiMap<String, LogFile> getModuleLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados asociados con el módulo.

Devoluciones
MultiMap <String, LogFile >

obtener archivos de registro no asociados

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todos los archivos registrados no asociados con una ejecución de prueba o un módulo.

Devoluciones
MultiMap <String, LogFile >

getNumAllEjecuciones de prueba fallidas

public int getNumAllFailedTestRuns ()

Devuelve el número total de ejecuciones de prueba en estado de error.

Devoluciones
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Devuelve el número total de pruebas en un estado de error (solo las pruebas fallidas, las supuestas fallas no cuentan para ello).

Devoluciones
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Devuelve el número de pruebas en un estado determinado para esta ejecución.

Parámetros
status TestStatus

Devoluciones
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Para compatibilidad con tipos de estado anteriores

Parámetros
ddmlibStatus TestResult.TestStatus

Devoluciones
int

obtenerNumTotalPruebas

public int getNumTotalTests ()

Devuelve el número total de pruebas completas para todas las ejecuciones.

Devoluciones
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Devuelve la información de compilación principal que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext) . La compilación primaria es la compilación devuelta por el primer proveedor de compilación de la configuración en ejecución. Devuelve nulo si no hay contexto (no hay compilación para el caso de prueba).

Devoluciones
IBuildInfo

getRunResults

public  getRunResults ()

Este método está en desuso.
Utilice getMergedTestRunResults()

Devuelve los resultados de todas las ejecuciones de prueba.

Devoluciones

getTestRunAtIntent

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Devuelve TestRunResult para un solo intento.

Parámetros
testRunName String : el nombre dado por { testRunStarted(String, int) .

attempt int : la identificación del intento.

Devoluciones
TestRunResult TestRunResult para el nombre de pila y el ID de intento o null si no existe.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Devuelve el número de intentos para un nombre de ejecución de prueba determinado.

Parámetros
testRunName String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Obtiene todos los intentos de TestRunResult de una ejecución de prueba determinada.

Parámetros
testRunName String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
Todos TestRunResult de una ejecución de prueba determinada, ordenados por intentos.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Obtiene todos los resultados de un intento determinado.

Parámetros
attempt int : el intento para el que queremos resultados.

Devoluciones
Todo TestRunResult para un intento determinado.

obtener nombres de ejecución de prueba

public  getTestRunNames ()

Devuelve todos los nombres de todas las ejecuciones de prueba.

Es posible que estas ejecuciones de prueba se hayan ejecutado varias veces con diferentes intentos.

Devoluciones

ha fallado las pruebas

public boolean hasFailedTests ()

Devuelve si la invocación tuvo alguna prueba fallida o suposición fallida.

Devoluciones
boolean

tieneTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Devuelve si un nombre de ejecución de prueba determinado tiene algún resultado.

Parámetros
testRunName String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
boolean

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

está desactivado

public boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita la configuración y el desmontaje). Falso en caso contrario.

Devoluciones
boolean

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.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Este método está en desuso.
Ya no es necesario realizar pruebas.

Establece la información de compilación. Sólo debe usarse para pruebas.

Parámetros
buildInfo IBuildInfo

establecerDesactivar

public void setDisable (boolean isDisabled)

Establece si el objeto debe deshabilitarse. Deshabilitado significa que se deben omitir los pasos de configuración y desmontaje. Se puede utilizar para desactivar un objeto de forma predeterminada en el constructor predeterminado.

Parámetros
isDisabled boolean : el estado en el que se debe colocar el objeto.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Establece la MergeStrategy que se utilizará al fusionar resultados.

Parámetros
strategy MergeStrategy

pruebaSuposiciónFracaso

public 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 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 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 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 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 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 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 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 name, 
                int numTests, 
                int attemptNumber)

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.

pruebaRunStarted

public void testRunStarted (String name, 
                int numTests)

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

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

pruebaEjecutarDetenido

public void testRunStopped (long elapsedTime)

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
elapsedTime long : tiempo transcurrido informado por el dispositivo, en milisegundos

prueba omitida

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

borrar archivos de registro de módulo

protected final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo por lo que evitamos llevarlos demasiado tiempo.

borrarResultadosParaNombre

protected final void clearResultsForName (String testRunName)

Permite borrar los resultados de un nombre de ejecución determinado. Sólo debe usarse en algunos casos como agregador de resultados.

Parámetros
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Alternar la opción 'métricas agregadas'

Parámetros
aggregate boolean