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 |
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 |
getMergedTestRunResults () Devuelve la colección fusionada de resultados para todas las ejecuciones en diferentes intentos. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Devuelve el |
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 |
getRunResults () Este método está en desuso. Usar | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Devuelve el |
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 | |
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 |
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 |
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 |
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 |
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 |
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 determinado. |
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
publicgetMergedTestRunResults ()
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
publicgetRunResults ()
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
publicgetTestRunAttempts (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
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 dado. |
getTestRunNames
publicgetTestRunNames ()
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 : el ERROR(/Throwable) causa 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 varios 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 sólida.
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 : la hora en que finalizó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
testMetrics | 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 | 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 | 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 : ERROR(/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 ERROR(/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 ERROR(/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 dado. 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 |