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

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

getMergedTestRunResults()

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

IInvocationContext getModuleContextForRunResult(String testRunName)

Devuelve el IInvocationContext del módulo asociado a los resultados.

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

getRunResults()

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

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Devuelve el TestRunResult para un solo intento.

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

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

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 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, 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 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, 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 una falla que se describe en FailureDescription.

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

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

public  getMergedTestRunResults ()

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

public  getRunResults ()

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

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 le asignó {testRunStarted(String, int).

Muestra
Son todos los TestRunResult para 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
Son todos los TestRunResult de un intento determinado.

getTestRunNames

public  getTestRunNames ()

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