Recolectando TestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener , IDisableable

java.lang.Objeto
↳	com.android.tradefed.result.CollectingTestListener

Subclases directas conocidas JsonHttpTestResultReporter , MetricsXMLResultReporter , ModuleListener , ReportPassedTests , ResultAggregator , ShardListener , SuiteResultReporter , XmlResultReporter JsonHttpTestResultReporter Un reportero de resultados que codifica los resultados de las métricas de prueba y bifurca la información del dispositivo en JSON y POST en un punto final de servicio HTTP MétricasXMLResultReporter MetricsXMLResultReporter escribe métricas de prueba y ejecuta métricas en un archivo XML en una carpeta especificada por el parámetro de carpeta de métricas en la fase de finalización de invocación de la prueba. ModuleListener Listener adjunto a cada IRemoteTest de cada módulo para recopilar la lista de resultados. InformePruebasAprobadas Informe en un archivo posibles filtros para excluir la prueba aprobada. Agregador de resultados Reenviador especial que agrega los resultados cuando es necesario, según la estrategia de reintento que se tomó. ShardListener Un ITestInvocationListener que recopila los resultados de un fragmento de invocación (también conocido como una división de invocación para ejecutarse en varios recursos en paralelo) y los reenvía a otro agente de escucha. SuiteResultReporter Recopile los resultados de las pruebas para una invocación completa de la suite y emita los resultados finales. Reportero de resultados Xml Escribe los resultados de JUnit en archivos XML en un formato consistente con XMLJUnitResultFormatter de Ant.

Subclases indirectas conocidas FormattedGeneratorReporter , XmlFormattedGeneratorReporter Reportero del generador formateado Reporter que permite generar reportes en un formato particular. XmlFormattedGeneratorReporter La implementación de FormattedGeneratorReporter , que da formato a la suite, da como resultado un formato xml.

---

Un ITestInvocationListener que recopilará todos los resultados de las pruebas.

Aunque las estructuras de datos utilizadas en este objeto son seguras para 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 está en desuso. confíe en IBuildInfo de getInvocationContext() .
TestRunResult	getCurrentRunResults () Obtiene los resultados de la ejecución de la prueba actual.
int	getExpectedTests () Devuelve el número de pruebas esperadas.
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 fusionada 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 todo el archivo registrado asociado con el módulo
MultiMap <String, LogFile >	getNonAssociatedLogFiles () Devuelve una copia del mapa que contiene todo el archivo registrado no asociado con una ejecución de prueba o un módulo.
int	getNumAllFailedTestRuns () Devuelve el número total de ejecuciones de prueba en un estado de falla
int	getNumAllFailedTests () Devuelve el número total de pruebas en estado de falla (solo fallidas, las suposiciones de fallas no cuentan para ello).
int	getNumTestsInState (TestResult.TestStatus status) Devuelve el número de pruebas en un estado determinado para esta ejecución.
int	getNumTotalTests () Devuelve el número total de pruebas completas 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 está en desuso. Usar getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt (String testRunName, int attempt) Devuelve el TestRunResult para un solo intento.
int	getTestRunAttemptCount (String testRunName) Devuelve el número 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 suposición fallida.
boolean	hasTestRunResultsForName (String testRunName) Devuelve si un nombre de ejecución de prueba dado tiene algún resultado.
void	invocationEnded (long elapsedTime) Informa que la invocación ha terminado, ya sea con éxito 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	invocationStarted ( IInvocationContext context) Informa el inicio de la invocación de prueba.
boolean	isDisabled () Devuelve True si todo el objeto está deshabilitado (omita tanto la instalación como el desmontaje).
void	logAssociation (String dataName, LogFile logFile) En algunos casos, el registro debe estar fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la devolución de llamada no es posible.
void	setBuildInfo ( IBuildInfo buildInfo) Este método está en desuso. Ya no es necesario para la prueba.
void	setDisable (boolean isDisabled) Establece si el objeto debe estar deshabilitado.
void	setMergeStrategy ( MergeStrategy strategy) Establece MergeStrategy para usar al fusionar resultados.
void	testAssumptionFailure ( TestDescription test, String trace) Llamado cuando una prueba atómica marca que asume una condición que es falsa
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Llamado cuando una prueba atómica marca que asume una condición que es falsa
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Informa el final de la ejecución de un caso de prueba individual.
void	testFailed ( TestDescription test, FailureDescription failure) Informa de la falla de un caso de prueba individual.
void	testFailed ( TestDescription test, String trace) Informa de 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 del final de la ejecución de un módulo.
void	testModuleStarted ( IInvocationContext moduleContext) Informa el comienzo de un módulo en ejecución.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Informa el final de la ejecución de la prueba.
void	testRunFailed ( FailureDescription failure) La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .
void	testRunFailed (String errorMessage) La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
void	testRunStarted (String name, int numTests, int attemptNumber) Informa del inicio de una ejecución de prueba.
void	testRunStarted (String name, int numTests) Informa del inicio de una ejecución de prueba.
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) Informa del inicio de una ejecución de prueba.
void	testRunStopped (long elapsedTime) La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
void	testStarted ( TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde 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 del inicio de un caso de prueba individual.

Métodos protegidos
final void	clearModuleLogFiles () Permite limpiar el archivo del módulo para evitar llevarlos demasiado tiempo.
final void	clearResultsForName (String testRunName) Permite borrar los resultados de un nombre de ejecución dado.
void	setIsAggregrateMetrics (boolean aggregate) Alternar la opción 'métricas agregadas'

Constructores públicos

Recolectando TestListener

public CollectingTestListener ()

Métodos públicos

getBuildInfo

public IBuildInfo getBuildInfo ()

Este método está en desuso.
confíe en IBuildInfo de getInvocationContext() .

Devuelve la información de compilación.

Devoluciones
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Obtiene los resultados de la ejecución de la prueba actual.

Tenga en cuenta que los resultados pueden no estar completos. Se recomienda probar el valor de TestRunResult.isRunComplete() y/o (@link TestRunResult#isRunFailure()} según corresponda antes de procesar los resultados.

Devoluciones
TestRunResult	el TestRunResult que representa los datos recopilados durante la última ejecución de la prueba

obtenerPruebasEsperadas

public int getExpectedTests ()

Devuelve el número de pruebas esperadas. Podría diferir de getNumTotalTests() si no se ejecutaran algunas pruebas.

Devoluciones
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Devoluciones
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

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

Si hay varios resultados, cada ejecución de prueba se fusiona y el último resultado de prueba sobrescribe los resultados de prueba de ejecuciones anteriores. Las ejecuciones de prueba se ordenan por número de intento.

Las métricas para el mismo intento se fusionarán en función de la preferencia establecida por aggregate-metrics . Las métricas finales serán las métricas del último intento.

Devoluciones

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

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

Parámetros
testRunName	String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
IInvocationContext	El IInvocationContext del módulo para un nombre de ejecución de prueba dado null si no hay resultados para ese nombre.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado asociado con el módulo

Devoluciones
MultiMap <String, LogFile >

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Devuelve una copia del mapa que contiene todo el archivo registrado no asociado con una ejecución de prueba o un módulo.

Devoluciones
MultiMap <String, LogFile >

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Devuelve el número total de ejecuciones de prueba en un estado de falla

Devoluciones
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Devuelve el número total de pruebas en estado de falla (solo fallidas, las suposiciones de fallas no cuentan para ello).

Devoluciones
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Devuelve el número de pruebas en un estado determinado para esta ejecución.

Parámetros
status	TestResult.TestStatus

Devoluciones
int

getNumTotalTests

public int getNumTotalTests ()

Devuelve el número total de pruebas completas para todas las ejecuciones.

Devoluciones
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 compilación devuelta por el primer proveedor de compilación de la configuración en ejecución. Devuelve nulo si no hay contexto (sin compilación para el caso de prueba).

Devoluciones
IBuildInfo

obtenerRunResults

public  getRunResults ()

Este método está en desuso.
Usar getMergedTestRunResults()

Devuelve los resultados de todas las ejecuciones de prueba.

Devoluciones

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Devuelve el TestRunResult para un solo intento.

Parámetros
testRunName	String : el nombre dado por { testRunStarted(String, int) .
attempt	int : la identificación del intento.

Devoluciones
TestRunResult	TestRunResult para el nombre dado e intento de identificación o null si no existe.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Devuelve el número de intentos para un nombre de ejecución de prueba determinado.

Parámetros
testRunName	String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Obtiene todos los intentos de un TestRunResult de una ejecución de prueba determinada.

Parámetros
testRunName	String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
	Todos 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 : el intento para el que queremos resultados.

Devoluciones
	Todo TestRunResult para un intento dado.

getTestRunNames

public  getTestRunNames ()

Devuelve todos los nombres de todas las ejecuciones de prueba.

Estas ejecuciones de prueba pueden haberse ejecutado varias veces con diferentes intentos.

Devoluciones

ha fallado en las pruebas

public boolean hasFailedTests ()

Devuelve si la invocación tuvo alguna prueba fallida o suposición fallida.

Devoluciones
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Devuelve si un nombre de ejecución de prueba dado tiene algún resultado.

Parámetros
testRunName	String : el nombre dado por { testRunStarted(String, int) .

Devoluciones
boolean

invocaciónTerminada

public void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
elapsedTime	long : el tiempo transcurrido de la invocación en ms

invocaciónError

public void invocationFailed (Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
cause	Throwable : la causa Throwable de la falla

invocaciónEmpezó

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco TradeFederation. Los reporteros deben anular este método para admitir informes de múltiples dispositivos.

Parámetros
context	IInvocationContext : información sobre la invocación

está desactivado

public boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita tanto la instalación como el desmontaje). Falso en caso contrario.

Devoluciones
boolean

asociación de registro

public void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con casos de prueba, pero la oportunidad de hacerlo directamente testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) la devolución de llamada no es posible. Por lo tanto, esta devolución de llamada permite proporcionar explícitamente una asociación fuerte.

Parámetros
dataName	String : 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 está en desuso.
Ya no es necesario para la prueba.

Establezca la información de compilación. Solo debe usarse para pruebas.

Parámetros
buildInfo	IBuildInfo

establecer Deshabilitar

public void setDisable (boolean isDisabled)

Establece si el objeto debe estar deshabilitado. Deshabilitado significa que se deben omitir los pasos de configuración y desmontaje. Se puede usar para deshabilitar un objeto de forma predeterminada en el constructor predeterminado.

Parámetros
isDisabled	boolean : el estado en el que se debe poner el objeto.

establecerMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Establece MergeStrategy para usar al fusionar resultados.

Parámetros
strategy	MergeStrategy

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription test, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test	TestDescription : identifica la prueba
trace	String : rastro de pila de falla

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test	TestDescription : identifica la prueba
failure	FailureDescription : FailureDescription que describe el error y su contexto.

pruebaTerminó

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente. Combínelo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medida precisa.

Parámetros
test	TestDescription : identifica la prueba
endTime	long : el tiempo que finalizó la prueba, medido a través de System.currentTimeMillis()
testMetrics	: un ERROR(/Map) de las métricas emitidas

pruebaTerminó

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 pasó. También devuelve cualquier métrica clave/valor que se haya 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

prueba fallida

public void testFailed (TestDescription test, 
                FailureDescription failure)

Informa de 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 el error y su contexto.

prueba fallida

public void testFailed (TestDescription test, 
                String trace)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test	TestDescription : identifica la prueba
trace	String : rastro de pila de falla

prueba ignorada

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 del final de la ejecución de un módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa el comienzo de un módulo en ejecución. Esta devolución de llamada está asociada con testModuleEnded() y es opcional en la secuencia. Solo se usa durante una carrera que usa módulos: corredores basados ​​en suite.

Parámetros
moduleContext	IInvocationContext : el IInvocationContext del módulo.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la prueba. FIXME: no podemos tener dos interfaces Map<> con un tipo diferente, por lo que tenemos que usar HashMap aquí.

Parámetros
elapsedTime	long : tiempo transcurrido informado por el dispositivo, en milisegundos
runMetrics	: pares clave-valor notificados al final de una ejecución de prueba con Metric .

pruebaRunFailed

public void testRunFailed (FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

Parámetros
failure	FailureDescription : FailureDescription que describe el error y su contexto.

pruebaRunFailed

public void testRunFailed (String errorMessage)

La ejecución de la prueba de informes no se pudo completar debido a un error fatal.

Parámetros
errorMessage	String : String que describe el motivo del error de ejecución.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Informa del inicio de una ejecución de prueba.

Parámetros
name	String : el nombre de la ejecución de prueba
numTests	int : número total de pruebas en ejecución de prueba
attemptNumber	int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Informa del inicio de una ejecución de prueba.

Parámetros
name	String : el nombre de la ejecución de prueba
numTests	int : número total de pruebas en ejecución de prueba

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Informa del inicio de una ejecución de prueba.

Parámetros
name	String : el nombre de la ejecución de prueba
numTests	int : número total de pruebas en ejecución de prueba
attemptNumber	int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.
startTime	long : la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.

TODO: actualmente sin usar, considere eliminar

Parámetros
elapsedTime	long : tiempo transcurrido informado por el dispositivo, en milisegundos

pruebaEmpezó

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde 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 : la hora en que comenzó la prueba, medida a través de System.currentTimeMillis()

pruebaEmpezó

public void testStarted (TestDescription test)

Informa del inicio de un caso de prueba individual. Interfaz anterior, 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 llevarlos demasiado tiempo.

borrarResultadosParaNombre

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)

Alternar la opción 'métricas agregadas'

Parámetros
aggregate	boolean