CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.CollectingTestListener |
Un ITestInvocationListener que recopilará todos los resultados de las pruebas.
Si bien las estructuras de datos que se usan en este objeto son seguras para subprocesos, las devoluciones de llamada de ITestInvocationListener se deben llamar en el orden correcto.
Resumen
Constructores públicos | |
|---|---|
CollectingTestListener()
|
|
Métodos públicos | |
|---|---|
IBuildInfo
|
getBuildInfo()
Este método dejó de estar disponible.
confiar en el |
TestRunResult
|
getCurrentRunResults()
Obtiene los resultados de la ejecución de prueba actual. |
int
|
getExpectedTests()
Devuelve la cantidad esperada de pruebas. |
IInvocationContext
|
getInvocationContext()
Devuelve el contexto de invocación que se informó a través de |
|
getMergedTestRunResults()
Devuelve la colección combinada 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 todos los archivos registrados asociados con el módulo. |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
Devuelve una copia del mapa que contiene todos los archivos registrados que no están asociados con una ejecución de prueba o un módulo. |
int
|
getNumAllFailedTestRuns()
Devuelve la cantidad total de ejecuciones de pruebas en estado de falla. |
int
|
getNumAllFailedTests()
Devuelve la cantidad total de pruebas en estado de falla (solo fallas; las fallas de suposición no se incluyen en el recuento). |
int
|
getNumTestsInState(TestStatus status)
Devuelve la cantidad de pruebas en el estado determinado para esta ejecución. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
Para la compatibilidad con tipos de estado anteriores |
int
|
getNumTotalTests()
Devuelve la cantidad total de pruebas completadas 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 dejó de estar disponible.
Usa |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
Devuelve el |
int
|
getTestRunAttemptCount(String testRunName)
Devuelve la cantidad 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 alguna suposición fallida. |
boolean
|
hasTestRunResultsForName(String testRunName)
Devuelve si un nombre de ejecución de prueba determinado tiene resultados. |
void
|
invocationEnded(long elapsedTime)
Informa que la invocación finalizó, ya sea correctamente 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 que se omitió una invocación |
void
|
invocationStarted(IInvocationContext context)
Informa el inicio de la invocación de la prueba. |
boolean
|
isDisabled()
Devuelve True si todo el objeto está inhabilitado (omite la configuración y la limpieza). |
void
|
logAssociation(String dataName, LogFile logFile)
En algunos casos, el registro debe estar fuertemente asociado con los casos de prueba, pero no es posible hacerlo en la devolución de llamada directa de |
void
|
setBuildInfo(IBuildInfo buildInfo)
Este método dejó de estar disponible. Ya no es necesario para las pruebas. |
void
|
setDisable(boolean isDisabled)
Establece si el objeto debe inhabilitarse. |
void
|
setMergeStrategy(MergeStrategy strategy)
Establece el |
void
|
testAssumptionFailure(TestDescription test, String trace)
Se llama cuando una prueba atómica marca que supone una condición que es falsa |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición que es falsa |
void
|
testEnded(TestDescription test, long endTime,
Es una alternativa a |
void
|
testEnded(TestDescription test,
Informa el final de la ejecución de un caso de prueba individual. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Informa la falla de un caso de prueba individual. |
void
|
testFailed(TestDescription test, String trace)
Informa 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 el final de la ejecución de un módulo. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Informa el inicio de la ejecución de un módulo. |
void
|
testRunEnded(long elapsedTime,
Informa el final de la ejecución de la prueba. |
void
|
testRunFailed(FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en |
void
|
testRunFailed(String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error fatal. |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
Informa el inicio de una ejecución de prueba. |
void
|
testRunStarted(String name, int numTests)
Informa el inicio de una ejecución de prueba. |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
Informa el inicio de una ejecución de prueba. |
void
|
testRunStopped(long elapsedTime)
Se detuvo la ejecución de prueba de los informes antes de que se completara 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 no se espera habitualmente. |
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 para evitar que se mantenga durante demasiado tiempo. |
final
void
|
clearResultsForName(String testRunName)
Permite borrar los resultados de un nombre de ejecución determinado. |
final
void
|
clearTestRunResults()
Permite borrar todos los resultados de la ejecución de pruebas para evitar conservarlos durante demasiado tiempo. |
void
|
setIsAggregrateMetrics(boolean aggregate)
Activa o desactiva la opción "Métricas agregadas". |
Constructores públicos
CollectingTestListener
public CollectingTestListener ()
Métodos públicos
getBuildInfo
public IBuildInfo getBuildInfo ()
Este método dejó de estar disponible.
confiar en el IBuildInfo de getInvocationContext()
Devuelve la información de compilación.
| Muestra | |
|---|---|
IBuildInfo |
|
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Obtiene los resultados de la ejecución de prueba actual.
Ten en cuenta que es posible que los resultados no estén completos. Se recomienda probar el valor de TestRunResult.isRunComplete() o (@link TestRunResult#isRunFailure()} según corresponda antes de procesar los resultados.
| Muestra | |
|---|---|
TestRunResult |
El TestRunResult que representa los datos recopilados durante la última ejecución de la prueba |
getExpectedTests
public int getExpectedTests ()
Devuelve la cantidad esperada de pruebas. Podría diferir de getNumTotalTests() si no se ejecutaron algunas pruebas.
| Muestra | |
|---|---|
int |
|
getInvocationContext
public IInvocationContext getInvocationContext ()
Devuelve el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext).
| Muestra | |
|---|---|
IInvocationContext |
|
getMergedTestRunResults
publicgetMergedTestRunResults ()
Devuelve la colección combinada de resultados para todas las ejecuciones en diferentes intentos.
Si hay varios resultados, se combina cada ejecución de prueba, y el resultado de la prueba más reciente reemplaza los resultados de las pruebas de las ejecuciones anteriores. Las ejecuciones de prueba se ordenan por número de intento.
Las métricas del mismo intento se combinarán según la preferencia establecida por aggregate-metrics. Las métricas finales serán las del último intento.
| Muestra | |
|---|---|
|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Devuelve el IInvocationContext del módulo asociado a los resultados.
| Parámetros | |
|---|---|
testRunName |
String: Es el nombre que le asignó {testRunStarted(String, int). |
| Muestra | |
|---|---|
IInvocationContext |
El IInvocationContext del módulo para un nombre de ejecución de prueba determinado null si no hay resultados para ese nombre. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Devuelve una copia del mapa que contiene todos los archivos registrados asociados con el módulo.
| Muestra | |
|---|---|
MultiMap<String, LogFile> |
|
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Devuelve una copia del mapa que contiene todos los archivos registrados que no están asociados con una ejecución de prueba o un módulo.
| Muestra | |
|---|---|
MultiMap<String, LogFile> |
|
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Devuelve la cantidad total de ejecuciones de pruebas en estado de falla.
| Muestra | |
|---|---|
int |
|
getNumAllFailedTests
public int getNumAllFailedTests ()
Devuelve la cantidad total de pruebas en estado de falla (solo fallas; las fallas de suposición no se incluyen en el recuento).
| Muestra | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Devuelve la cantidad de pruebas en el estado determinado para esta ejecución.
| Parámetros | |
|---|---|
status |
TestStatus |
| Muestra | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Para la compatibilidad con tipos de estado anteriores
| Parámetros | |
|---|---|
ddmlibStatus |
TestResult.TestStatus |
| Muestra | |
|---|---|
int |
|
getNumTotalTests
public int getNumTotalTests ()
Devuelve la cantidad total de pruebas completadas para todas las ejecuciones.
| Muestra | |
|---|---|
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 que devuelve 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).
| Muestra | |
|---|---|
IBuildInfo |
|
getRunResults
publicgetRunResults ()
Este método dejó de estar disponible.
Usa getMergedTestRunResults()
Devuelve los resultados de todas las ejecuciones de prueba.
| Muestra | |
|---|---|
|
|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Devuelve el TestRunResult para un solo intento.
| Parámetros | |
|---|---|
testRunName |
String: Es el nombre que le asignó {testRunStarted(String, int). |
attempt |
int: Es el ID del intento. |
| Muestra | |
|---|---|
TestRunResult |
El TestRunResult para el nombre y el ID de intento determinados, o null si no existe. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Devuelve la cantidad de intentos para un nombre de ejecución de prueba determinado.
| Parámetros | |
|---|---|
testRunName |
String: Es el nombre que le asignó {testRunStarted(String, int). |
| Muestra | |
|---|---|
int |
|
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Obtiene todos los intentos de un TestRunResult de una ejecución de prueba determinada.
| Parámetros | |
|---|---|
testRunName |
String: Es el nombre que le asignó {testRunStarted(String, int). |
| Muestra | |
|---|---|
|
Son todos los 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: Es el intento para el que queremos obtener resultados. |
| Muestra | |
|---|---|
|
Son todos los TestRunResult de un intento determinado. |
getTestRunNames
publicgetTestRunNames ()
Devuelve todos los nombres de todas las ejecuciones de prueba.
Es posible que estas ejecuciones de prueba se hayan realizado varias veces con diferentes intentos.
| Muestra | |
|---|---|
|
|
hasFailedTests
public boolean hasFailedTests ()
Devuelve si la invocación tuvo alguna prueba fallida o alguna suposición fallida.
| Muestra | |
|---|---|
boolean |
|
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Devuelve si un nombre de ejecución de prueba determinado tiene resultados.
| Parámetros | |
|---|---|
testRunName |
String: Es el nombre que le asignó {testRunStarted(String, int). |
| Muestra | |
|---|---|
boolean |
|
invocationEnded
public void invocationEnded (long elapsedTime)
Informa que la invocación finalizó, ya sea correctamente o debido a alguna condición de error.
El framework de TradeFederation lo llamará automáticamente.
| Parámetros | |
|---|---|
elapsedTime |
long: Es el tiempo transcurrido de la invocación en ms. |
invocationFailed
public void invocationFailed (Throwable cause)
Informa una invocación incompleta debido a alguna condición de error.
El framework de TradeFederation lo llamará automáticamente.
| Parámetros | |
|---|---|
cause |
Throwable: Es la causa Throwable de la falla. |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Informa que se omitió una invocación
| Parámetros | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
Informa el inicio de la invocación de la prueba.
El framework de TradeFederation lo llamará automáticamente. Los reporteros deben anular este método para admitir la generación de informes de varios dispositivos.
| Parámetros | |
|---|---|
context |
IInvocationContext: Información sobre la invocación |
isDisabled
public boolean isDisabled ()
Devuelve True si todo el objeto está inhabilitado (omite la configuración y la limpieza). De lo contrario, es falso.
| Muestra | |
|---|---|
boolean |
|
logAssociation
public void logAssociation (String dataName,
LogFile logFile)En algunos casos, el registro debe estar fuertemente asociado con los casos de prueba, pero no es posible hacerlo en la devolución de llamada directa de testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Por lo tanto, esta devolución de llamada permite proporcionar una asociación sólida de forma explícita.
| Parámetros | |
|---|---|
dataName |
String: El nombre de los datos |
logFile |
LogFile: Es el LogFile que se registró antes y que debe asociarse con el caso de prueba. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Este método dejó de estar disponible.
Ya no es necesario para las pruebas.
Establece la información de compilación. Solo se debe usar para pruebas.
| Parámetros | |
|---|---|
buildInfo |
IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Establece si el objeto debe inhabilitarse. Inhabilitado significa que se deben omitir los pasos de configuración y de cierre. Se puede usar para inhabilitar un objeto de forma predeterminada en el constructor predeterminado.
| Parámetros | |
|---|---|
isDisabled |
boolean: Es el estado en el que se debe colocar el objeto. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Establece el MergeStrategy que se usará cuando se combinen los resultados.
| Parámetros | |
|---|---|
strategy |
MergeStrategy |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Se llama cuando una prueba atómica marca que supone una condición que es falsa
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
trace |
String: Es el seguimiento de pila de la falla. |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición que es falsa
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
failure |
FailureDescription: FailureDescription que describe la falla y su contexto. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Es una alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medición precisa.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
endTime |
long: Es la fecha y hora en que finalizó la prueba, medida a través de System.currentTimeMillis(). |
testMetrics |
: Un ERROR(/Map) de las métricas emitidas |
testEnded
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 se aprobó. También devuelve las métricas de clave/valor que se hayan 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 |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Informa 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 la falla y su contexto. |
testFailed
public void testFailed (TestDescription test, String trace)
Informa la falla de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
trace |
String: Es el seguimiento de pila de la falla. |
testIgnored
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 el final de la ejecución de un módulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Informa el inicio de la ejecución de un módulo. Esta devolución de llamada está asociada a testModuleEnded() y es opcional en la secuencia. Solo se usa durante una ejecución que utiliza módulos: ejecutores basados en conjuntos de pruebas.
| Parámetros | |
|---|---|
moduleContext |
IInvocationContext: Es el IInvocationContext del módulo. |
testRunEnded
public void testRunEnded (long elapsedTime,
runMetrics) Informa el final de la ejecución de la prueba.
| Parámetros | |
|---|---|
elapsedTime |
long: Tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics |
: Pares clave-valor que se registran al final de una ejecución de prueba |
testRunFailed
public void testRunFailed (FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en FailureDescription.
| Parámetros | |
|---|---|
failure |
FailureDescription: FailureDescription que describe la falla y su contexto. |
testRunFailed
public void testRunFailed (String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error fatal.
| Parámetros | |
|---|---|
errorMessage |
String: String que describe el motivo de la falla de la ejecución. |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber)Informa el inicio de una ejecución de prueba.
| Parámetros | |
|---|---|
name |
String: Es el nombre de la ejecución de la prueba. |
numTests |
int: Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se realice una nueva ejecución. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3. |
testRunStarted
public void testRunStarted (String name,
int numTests)Informa el inicio de una ejecución de prueba.
| Parámetros | |
|---|---|
name |
String: Es el nombre de la ejecución de la prueba. |
numTests |
int: Es la cantidad total de pruebas en la ejecución de prueba. |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber,
long startTime)Informa el inicio de una ejecución de prueba.
| Parámetros | |
|---|---|
name |
String: Es el nombre de la ejecución de la prueba. |
numTests |
int: Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se ejecute una prueba nueva. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3. |
startTime |
long: Es la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis(). |
testRunStopped
public void testRunStopped (long elapsedTime)
Se detuvo la ejecución de prueba de los informes antes de que se completara debido a una solicitud del usuario.
TODO: Actualmente no se usa. Considera quitarlo.
| Parámetros | |
|---|---|
elapsedTime |
long: Tiempo transcurrido informado por el dispositivo, en milisegundos |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que no se espera habitualmente. Se intentará volver a ejecutar estas pruebas para obtener una ejecución adecuada.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
reason |
SkipReason: SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription) en la que 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: Es la fecha y hora en que comenzó la prueba, medida a través de System.currentTimeMillis(). |
testStarted
public void testStarted (TestDescription test)
Informa el inicio de un caso de prueba individual. Interfaz más antigua. Se 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 que se mantenga durante demasiado tiempo.
clearResultsForName
protected final void clearResultsForName (String testRunName)
Permite borrar los resultados de un nombre de ejecución determinado. Solo se debe usar en algunos casos, como el agregador de resultados.
| Parámetros | |
|---|---|
testRunName |
String |
clearTestRunResults
protected final void clearTestRunResults ()
Permite borrar todos los resultados de la ejecución de pruebas para evitar conservarlos durante demasiado tiempo.
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Activa o desactiva la opción "Métricas agregadas".
| Parámetros | |
|---|---|
aggregate |
boolean |