RecopilarTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
Objeto java.lang. | |
↳ | com.android.tradefed.result.CollectingTestListener |
Un elemento 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.
se basan en el |
TestRunResult
|
getCurrentRunResults()
Obtiene los resultados de la ejecución de la prueba actual. |
int
|
getExpectedTests()
Muestra el recuento de pruebas esperado. |
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()
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 una módulo. |
int
|
getNumAllFailedTestRuns()
Devuelve la cantidad total de ejecuciones de pruebas en estado de error. |
int
|
getNumAllFailedTests()
Devuelve la cantidad total de pruebas en un estado de error (solo con errores; las suposiciones con errores no lo hacen contar para ese fin). |
int
|
getNumTestsInState(TestStatus status)
Muestra la cantidad de pruebas en un estado determinado para esta ejecución. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
Para brindar compatibilidad con el tipo de estado anterior |
int
|
getNumTotalTests()
Muestra la cantidad total de pruebas completas para 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 con errores o si la suposición falló. |
boolean
|
hasTestRunResultsForName(String testRunName)
Muestra si un nombre de ejecución de prueba determinado tiene resultados. |
void
|
invocationEnded(long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado. |
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()
Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). |
void
|
logAssociation(String dataName, LogFile logFile)
En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo
así que en el |
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 objeto |
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 asume una condición falsa. |
void
|
testEnded(TestDescription test, long endTime,
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 ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar. |
void
|
testModuleEnded()
Informa el final de la ejecución de un módulo. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Informa el comienzo 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 los 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)
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 que no se lleven durante mucho tiempo. |
final
void
|
clearResultsForName(String testRunName)
Permite borrar los resultados de un nombre de ejecución determinado. |
void
|
setIsAggregrateMetrics(boolean aggregate)
Activar o desactivar “Métricas agregadas” opción |
Constructores públicos
RecopilarTestListener
public CollectingTestListener ()
Métodos públicos
getBuildInfo
public IBuildInfo getBuildInfo ()
Este método dejó de estar disponible.
se basan en el 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 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 objeto TestRunResult que representa los datos recopilados durante la última ejecución de prueba |
getExpectedTests
public int getExpectedTests ()
Muestra el recuento de pruebas esperado. Podría diferir de getNumTotalTests()
si
no se ejecutaron algunas pruebas.
Muestra | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Muestra 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, cada ejecución de prueba se combina con el resultado más reciente. y reemplazar los resultados de las ejecuciones anteriores. Las ejecuciones de prueba se ordenan según el número de intento.
Las métricas del mismo intento se combinarán según la preferencia que estableció 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 ()
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 no asociados con una ejecución de prueba o una 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 ()
Devuelve la cantidad total de pruebas en un estado de error (solo con errores; las suposiciones con errores no lo hacen contar para ese fin).
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 brindar compatibilidad con el tipo de estado anterior
Parámetros | |
---|---|
ddmlibStatus |
TestResult.TestStatus |
Muestra | |
---|---|
int |
getNumTotalTests.
public int getNumTotalTests ()
Muestra la cantidad total de pruebas completas para 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 devuelve la primera
de compilación de la configuración en ejecución. El resultado es nulo si no hay contexto (no hay ninguna compilación en
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 proporciona {testRunStarted(String, int) . |
attempt |
int : Es el ID del intento. |
Muestra | |
---|---|
TestRunResult |
El TestRunResult para el nombre y el ID del intento específicos, o bien null si
no existe. |
getTestRunAttemptCount.
public int getTestRunAttemptCount (String testRunName)
Muestra la cantidad de intentos para un nombre de ejecución de prueba determinado.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que proporciona {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 proporciona {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 | |
---|---|
|
Son 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 realizado varias veces con distintos intentos.
Muestra | |
---|---|
|
hasFailedTests
public boolean hasFailedTests ()
Muestra si la invocación tuvo pruebas con errores o si la suposición falló.
Muestra | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Muestra si un nombre de ejecución de prueba determinado tiene resultados.
Parámetros | |
---|---|
testRunName |
String : Es el nombre que proporciona {testRunStarted(String, int) . |
Muestra | |
---|---|
boolean |
invocaciónFinalizada
public void invocationEnded (long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.
Se llamará automáticamente a través del marco TradeFederation.
Parámetros | |
---|---|
elapsedTime |
long : El tiempo transcurrido de la invocación en ms |
Error de invocación
public void invocationFailed (Throwable cause)
Informa una invocación incompleta debido a alguna condición de error.
Se llamará automáticamente a través del marco TradeFederation.
Parámetros | |
---|---|
cause |
Throwable : Es la causa Throwable de la falla. |
se omitió el proceso de invocación
public void invocationSkipped (SkipReason reason)
Informa una invocación como omitida
Parámetros | |
---|---|
reason |
SkipReason |
iniciación de invocación
public void invocationStarted (IInvocationContext context)
Informa el inicio de la invocación de prueba.
Se llamará automáticamente a través del 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 |
Inhabilitado
public boolean isDisabled ()
Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). De lo contrario, el valor es falso.
Muestra | |
---|---|
boolean |
Asociación de registro
public void logAssociation (String dataName, LogFile logFile)
En algunos casos, el registro debe estar estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo
así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
directo
no es posible realizar la devolución de llamada. Esta devolución de llamada permite proporcionar una asociación sólida
de forma explícita.
Parámetros | |
---|---|
dataName |
String : Es 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 dejó de estar disponible.
Ya no es necesario para las pruebas.
Configura 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. Si está inhabilitado, significa que los pasos de configuración y desconexión se deben omitir. Se puede usar para inhabilitar un objeto de forma predeterminada en el .
Parámetros | |
---|---|
isDisabled |
boolean : Es el estado en el que se debe colocar el objeto. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Establece el objeto MergeStrategy
que se usará cuando se combinen los resultados.
Parámetros | |
---|---|
strategy |
MergeStrategy |
ErrordeAsuncióndeprueba
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 las fallas |
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 |
pruebaFinalizada
public void testEnded (TestDescription test, long endTime,testMetrics)
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 mediciones precisas.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
endTime |
long : La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis() |
testMetrics |
: Una 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 se completó correctamente. También muestra cualquier par clave-valor.
métricas que podrían haberse emitido durante la ejecución del caso de prueba.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
testMetrics |
: Una ERROR(/Map) de las métricas emitidas |
Prueba con errores
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 |
Prueba con errores
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 |
pruebaIgnorada
public void testIgnored (TestDescription test)
Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
módulodepruebafinalizado
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 paquetes.
Parámetros | |
---|---|
moduleContext |
IInvocationContext : Es el IInvocationContext del módulo. |
pruebaRunfinalizada
public void testRunEnded (long elapsedTime,runMetrics)
Informa el final de la ejecución de la prueba. FIXME: No podemos tener dos mapas<> con diferentes tipos, por lo que aquí tenemos que usar HashMap.
Parámetros | |
---|---|
elapsedTime |
long : Es el tiempo transcurrido informado por el dispositivo en milisegundos. |
runMetrics |
: Son pares clave-valor que se informan al final de una ejecución de prueba con Metric . |
Error de ejecución de prueba
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 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 : Cantidad total de pruebas en la ejecución de prueba |
attemptNumber |
int : Número de pedido, que identifica los diferentes intentos del mismo runName
que se ejecutan varias veces. El valor de tryNumber tiene un índice 0 y debería aumentarse cada vez
se ejecuta una nueva ejecución. p.ej., Se vuelve a intentar una prueba detallada 3 veces; debería tener 4 en total
se ejecuta con el mismo runName y tryNumber del 0 al 3. |
pruebaRunStarted
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 : 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 : Cantidad total de pruebas en la ejecución de prueba |
attemptNumber |
int : Número de pedido, que identifica los diferentes intentos del mismo runName
que se ejecutan varias veces. El valor de intentNumber tiene un índice 0 y debería aumentarse cada vez que se genera un
una nueva carrera. p.ej., Se vuelve a intentar una prueba detallada 3 veces, por lo que debería tener 4 ejecuciones en total
con el mismo runName e tryNumber del 0 al 3. |
startTime |
long : Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis() . |
pruebaRundetenida
public void testRunStopped (long elapsedTime)
La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario.
PENDIENTE: Actualmente sin uso, te recomendamos que lo quites
Parámetros | |
---|---|
elapsedTime |
long : Es el 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 normalmente no se espera. Se intentará volver a realizar estas pruebas para que se ejecute correctamente.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
reason |
SkipReason : SkipReason |
Iniciodeprueba
public void testStarted (TestDescription test, long startTime)
Es una alternativa a testStarted(com.android.tradefed.result.TestDescription)
, donde también especificamos cuándo se realizó la prueba.
comenzó y se combinó 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 mediante System.currentTimeMillis() . |
Iniciodeprueba
public void testStarted (TestDescription test)
Informa el inicio de un caso de prueba individual. Esta interfaz es antigua y 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 debe usarse en algunos casos, como el agregador de resultados.
Parámetros | |
---|---|
testRunName |
String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Activar o desactivar “Métricas agregadas” opción
Parámetros | |
---|---|
aggregate |
boolean |