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 IBuildInfo de getInvocationContext().

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getMergedTestRunResults()

Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

IInvocationContext getModuleContextForRunResult(String testRunName)

Muestra el IInvocationContext del módulo asociado con los resultados.

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getRunResults()

Este método dejó de estar disponible. Usa getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Muestra el TestRunResult para un solo intento.

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 TestRunResult de una ejecución de prueba determinada.

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

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 MergeStrategy que se usará cuando se combinen los resultados.

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, testMetrics)

Es una alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente.

void testEnded(TestDescription test, testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

void testFailed(TestDescription test, FailureDescription failure)

Informa el error de un caso de prueba individual.

void testFailed(TestDescription test, String trace)

Informa el error de un caso de prueba individual.

void testIgnored(TestDescription test)

Se llama cuando no se 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, runMetrics)

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 FailureDescription.

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 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.

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

public  getMergedTestRunResults ()

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

public  getRunResults ()

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

public  getTestRunAttempts (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.

public  getTestRunForAttempts (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

public  getTestRunNames ()

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