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 la prueba.
Aunque las estructuras de datos que se usan en este objeto son seguras para los 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 dejó de estar disponible.
dependen del |
TestRunResult
|
getCurrentRunResults()
Obtiene los resultados de la ejecución de prueba actual. |
int
|
getExpectedTests()
Muestra la cantidad de pruebas esperadas. |
IInvocationContext
|
getInvocationContext()
Muestra el contexto de invocación que se informó a través de |
|
getMergedTestRunResults()
Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
Muestra el |
MultiMap<String, LogFile>
|
getModuleLogFiles()
Muestra una copia del mapa que contiene todo el archivo registrado asociado con el módulo. |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
Muestra una copia del mapa que contiene todo el archivo registrado que no está asociado con una ejecución de prueba o un módulo. |
int
|
getNumAllFailedTestRuns()
Muestra la cantidad total de ejecuciones de prueba en un estado de error. |
int
|
getNumAllFailedTests()
Muestra la cantidad total de pruebas en un estado de error (solo las pruebas fallidas, las fallas de suposición no se tienen en cuenta). |
int
|
getNumTestsInState(TestStatus status)
Muestra la cantidad de pruebas en un estado determinado para esta ejecución. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
Para lograr la compatibilidad con tipos de estado más antiguos |
int
|
getNumTotalTests()
Muestra la cantidad total de pruebas completas de todas las ejecuciones. |
IBuildInfo
|
getPrimaryBuildInfo()
Muestra 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)
Muestra el |
int
|
getTestRunAttemptCount(String testRunName)
Muestra 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()
Muestra todos los nombres de todas las ejecuciones de prueba. |
boolean
|
hasFailedTests()
Muestra si la invocación tuvo pruebas fallidas o de suposición fallida. |
boolean
|
hasTestRunResultsForName(String testRunName)
Muestra si un nombre de ejecución de prueba determinado tiene algún resultado. |
void
|
invocationEnded(long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta 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 prueba. |
boolean
|
isDisabled()
Muestra el valor True si se inhabilita el objeto completo (omite la configuración y la eliminación). |
void
|
logAssociation(String dataName, LogFile logFile)
En algunos casos, el registro debe estar fuertemente asociado con un caso 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 se debe inhabilitar. |
void
|
setMergeStrategy(MergeStrategy strategy)
Establece el |
void
|
testAssumptionFailure(TestDescription test, String trace)
Se llama cuando una prueba atómica marca que asume una condición falsa. |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición 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 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 ejecutará una prueba, por lo general, 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 un error que describe |
void
|
testRunFailed(String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave. |
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)
La ejecución de 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 no suele esperarse. |
void
|
testStarted(TestDescription test, long startTime)
Es una 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 cargue durante demasiado tiempo. |
final
void
|
clearResultsForName(String testRunName)
Permite borrar los resultados de un nombre de ejecución determinado. |
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.
depende de IBuildInfo
de getInvocationContext()
.
Muestra la información de compilación.
Muestra | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Obtiene los resultados de la ejecución de la prueba actual.
Ten en cuenta que los resultados pueden no estar 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 prueba |
getExpectedTests
public int getExpectedTests ()
Muestra la cantidad de pruebas esperadas. Podría ser diferente 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 ()
Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.
Si hay varios resultados, se combinan cada ejecución de prueba, y el resultado más reciente reemplaza los resultados 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)
Muestra el IInvocationContext
del módulo asociado con los resultados.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que proporciona {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 ()
Muestra una copia del mapa que contiene todo el archivo registrado asociado con el módulo.
Muestra | |
---|---|
MultiMap<String, LogFile> |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Muestra una copia del mapa que contiene todo el archivo registrado que no está asociado 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 error.
Muestra | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Muestra la cantidad total de pruebas en estado de error (solo con errores, las suposiciones de errores no se tienen en cuenta).
Muestra | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Muestra la cantidad de pruebas en un estado determinado para esta ejecución.
Parámetros | |
---|---|
status |
TestStatus |
Muestra | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Para lograr la compatibilidad con tipos de estado más antiguos
Parámetros | |
---|---|
ddmlibStatus |
TestResult.TestStatus |
Muestra | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Muestra la cantidad total de pruebas completas de todas las ejecuciones.
Muestra | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Muestra 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 muestra el primer proveedor de compilación de la configuración en ejecución. Devuelve un valor 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()
Muestra los resultados de todas las ejecuciones de prueba.
Muestra | |
---|---|
|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Muestra el TestRunResult
de un solo intento.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que se le asignó a {testRunStarted(String, int) . |
attempt |
int : Es el ID del intento. |
Muestra | |
---|---|
TestRunResult |
El TestRunResult para el nombre determinado y el ID de intento, o null si no existe. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Muestra la cantidad de intentos de una ejecución de prueba determinada.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que se le asignó a {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 se le asignó a {testRunStarted(String, int) . |
Muestra | |
---|---|
|
Todos los 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 : Es el intento para el que queremos obtener resultados. |
Muestra | |
---|---|
|
Todos los TestRunResult de un intento determinado. |
getTestRunNames
publicgetTestRunNames ()
Muestra todos los nombres de todas las ejecuciones de prueba.
Es posible que estas ejecuciones de prueba se hayan ejecutado varias veces con diferentes intentos.
Muestra | |
---|---|
|
hasFailedTests
public boolean hasFailedTests ()
Muestra si la invocación tuvo pruebas fallidas o de suposición fallida.
Muestra | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Muestra si un nombre de ejecución de prueba determinado tiene algún resultado.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que proporciona {testRunStarted(String, int) . |
Muestra | |
---|---|
boolean |
invocationEnded
public void invocationEnded (long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a alguna condición de error.
El framework de TradeFederation lo llamará automáticamente.
Parámetros | |
---|---|
elapsedTime |
long : 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 del error. |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Informa que se omitió una invocación
Parámetros | |
---|---|
reason |
SkipReason |
iniciación de invocación
public void invocationStarted (IInvocationContext context)
Informa el inicio de la invocación de prueba.
El framework de TradeFederation lo llamará automáticamente. Los generadores de informes deben anular este método para admitir informes de varios dispositivos.
Parámetros | |
---|---|
context |
IInvocationContext : Información sobre la invocación |
Inhabilitado
public boolean isDisabled ()
Muestra verdadero si todo el objeto está inhabilitado (se omite la configuración y el desmontaje). De lo contrario, es falso.
Muestra | |
---|---|
boolean |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero no es posible hacerlo en la devolución de llamada directa a 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 manera explícita.
Parámetros | |
---|---|
dataName |
String : Es el nombre de los datos. |
logFile |
LogFile : Es el LogFile que se registró antes y debe estar asociado 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 debe usarse para pruebas.
Parámetros | |
---|---|
buildInfo |
IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Establece si el objeto se debe inhabilitar. Inhabilitado significa que se deben omitir los pasos de configuración y de desinstalación. 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 asume una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
trace |
String : seguimiento de pila de la falla |
ErrordeAsuncióndeprueba
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que asume una condición 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 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 completó. También muestra cualquier métrica de par clave-valor que se pueda haber 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 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 la falla y su contexto. |
testFailed
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 de las fallas |
testIgnored
public void testIgnored (TestDescription test)
Se llama cuando no se ejecutará una prueba, por lo general, 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ódulodepruebaIniciado
public void testModuleStarted (IInvocationContext moduleContext)
Informa el 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: ejecutores basados en suites.
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 prueba.
Parámetros | |
---|---|
elapsedTime |
long : Tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics |
: Son los pares clave-valor que se informan 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 un error que describe FailureDescription
.
Parámetros | |
---|---|
failure |
FailureDescription : FailureDescription que describe la falla y su contexto. |
Error de ejecución de prueba
public void testRunFailed (String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave.
Parámetros | |
---|---|
errorMessage |
String : String que describe el motivo de la falla de la ejecución. |
pruebaRunStarted
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 prueba. |
numTests |
int : Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int : Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va 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 prueba. |
numTests |
int : Es la cantidad total de pruebas en la ejecución de prueba. |
pruebaRunStarted
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 prueba. |
numTests |
int : Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int : Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va de 0 a 3. |
startTime |
long : Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis() . |
testRunStopped
public void testRunStopped (long elapsedTime)
La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
TODO: currently unused, consider removing
Parámetros | |
---|---|
elapsedTime |
long : Tiempo transcurrido informado por el dispositivo, en milisegundos |
pruebaOmitir
public void testSkipped (TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que no suele esperarse. Se intentará volver a realizar 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)
Es una 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 obtener una medición precisa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
startTime |
long : Es la hora en que comenzó la prueba, medida a través de System.currentTimeMillis() . |
Iniciodeprueba
public void testStarted (TestDescription test)
Informa el inicio de un caso de prueba individual. Interfaz más antigua, 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 que no se lleven durante mucho 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 |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Activa o desactiva la opción “Métricas agregadas”
Parámetros | |
---|---|
aggregate |
boolean |