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 |
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 |
getMergedTestRunResults () Devuelve la colección combinada de resultados de todas las ejecuciones en diferentes intentos. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Devuelve el |
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 |
getRunResults () Este método está en desuso. Utilice | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Devuelve |
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 | |
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 |
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 |
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 |
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 |
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 |
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
publicgetMergedTestRunResults ()
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
publicgetRunResults ()
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
publicgetTestRunAttempts (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
publicgetTestRunForAttempts (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
publicgetTestRunNames ()
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 | 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 | 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 | 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 |