Recolectando TestListener

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 la prueba actual.

int getExpectedTests ()

Devuelve el número de pruebas esperadas.

IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

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

IInvocationContext getModuleContextForRunResult (String testRunName)

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

MultiMap <String, LogFile > getModuleLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado asociado con el módulo

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado no asociado con una ejecución de prueba o un módulo.

int getNumAllFailedTestRuns ()

Devuelve el número total de ejecuciones de prueba en un estado de falla

int getNumAllFailedTests ()

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

int getNumTestsInState (TestResult.TestStatus status)

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

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. Usar getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Devuelve el 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 un 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 dado tiene algún resultado.

void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito 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 invocationStarted ( IInvocationContext context)

Informa el inicio de la invocación de prueba.

boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita tanto la instalación como el desmontaje).

void logAssociation (String dataName, LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente 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 para la prueba.

void setDisable (boolean isDisabled)

Establece si el objeto debe estar deshabilitado.

void setMergeStrategy ( MergeStrategy strategy)

Establece MergeStrategy para usar al fusionar resultados.

void testAssumptionFailure ( TestDescription test, String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Llamado cuando una prueba atómica marca 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 de la falla de un caso de prueba individual.

void testFailed ( TestDescription test, String trace)

Informa de la falla de un caso de prueba individual.

void testIgnored ( TestDescription test)

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

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

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

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 la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

void testRunFailed (String errorMessage)

La ejecución de la 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 testStarted ( TestDescription test, long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .

void testStarted ( TestDescription test)

Informa del inicio de un caso de prueba individual.

Métodos protegidos

final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo para evitar llevarlos demasiado tiempo.

final void clearResultsForName (String testRunName)

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

void setIsAggregrateMetrics (boolean aggregate)

Alternar la opción 'métricas agregadas'

Constructores públicos

Recolectando TestListener

public CollectingTestListener ()

Métodos públicos

getBuildInfo

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 la prueba actual.

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

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

obtenerPruebasEsperadas

public int getExpectedTests ()

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

Devoluciones
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Devoluciones
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

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

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

Las métricas para el mismo intento se fusionarán en función de 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 a 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 dado null si no hay resultados para ese nombre.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado asociado con el módulo

Devoluciones
MultiMap <String, LogFile >

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado no asociado con una ejecución de prueba o un módulo.

Devoluciones
MultiMap <String, LogFile >

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Devuelve el número total de ejecuciones de prueba en un estado de falla

Devoluciones
int

getNumAllFailedTests

public int getNumAllFailedTests ()

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

Devoluciones
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

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

Parámetros
status TestResult.TestStatus

Devoluciones
int

getNumTotalTests

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 principal 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 (sin compilación para el caso de prueba).

Devoluciones
IBuildInfo

obtenerRunResults

public  getRunResults ()

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

Devuelve los resultados de todas las ejecuciones de prueba.

Devoluciones

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Devuelve el 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 dado e intento de identificación 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 un TestRunResult de una ejecución de prueba determinada.

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

Devoluciones
Todos TestRunResult para 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 dado.

getTestRunNames

public  getTestRunNames ()

Devuelve todos los nombres de todas las ejecuciones de prueba.

Estas ejecuciones de prueba pueden haberse ejecutado varias veces con diferentes intentos.

Devoluciones

ha fallado en las pruebas

public boolean hasFailedTests ()

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

Devoluciones
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

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

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

Devoluciones
boolean

invocaciónTerminada

public void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

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

invocaciónError

public void invocationFailed (Throwable cause)

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

Será llamado automáticamente por el marco TradeFederation.

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

invocaciónEmpezó

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco 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 tanto la instalación como el desmontaje). Falso en caso contrario.

Devoluciones
boolean

asociación de registro

public void logAssociation (String dataName, 
                LogFile logFile)

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

Parámetros
dataName String : el nombre de los datos

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

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Este método está en desuso.
Ya no es necesario para la prueba.

Establezca la información de compilación. Solo debe usarse para pruebas.

Parámetros
buildInfo IBuildInfo

establecer Deshabilitar

public void setDisable (boolean isDisabled)

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

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

establecerMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Establece MergeStrategy para usar al fusionar resultados.

Parámetros
strategy MergeStrategy

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription test, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test TestDescription : identifica la prueba

trace String : rastro de pila de falla

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Llamado cuando una prueba atómica marca 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.

pruebaTerminó

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 : el tiempo que finalizó la prueba, medido a través de System.currentTimeMillis()

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

pruebaTerminó

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 se haya 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 de la falla 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 de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription : identifica la prueba

trace String : rastro de pila de falla

prueba ignorada

public void testIgnored (TestDescription test)

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: no podemos tener dos interfaces Map<> con un tipo diferente, por lo que tenemos que usar HashMap aquí.

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

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

pruebaRunFailed

public void testRunFailed (FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

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

pruebaRunFailed

public void testRunFailed (String errorMessage)

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

testRunStarted

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 orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

testRunStarted

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

testRunStarted

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 orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con 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 a través de System.currentTimeMillis()

testRunStopped

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 usar, considere eliminar

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

pruebaEmpezó

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

pruebaEmpezó

public void testStarted (TestDescription test)

Informa del inicio de un caso de prueba individual. Interfaz anterior, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription : identifica la prueba

Métodos protegidos

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo para evitar llevarlos demasiado tiempo.

borrarResultadosParaNombre

protected final void clearResultsForName (String testRunName)

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

Parámetros
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Alternar la opción 'métricas agregadas'

Parámetros
aggregate boolean