SubprocessResultsReporter
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Objeto | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Implementa ITestInvocationListener
para que se especifique como result_reporter y reenvía desde el subproceso los resultados de las pruebas, las ejecuciones de pruebas y las invocaciones de pruebas.
Resumen
Constructores públicos | |
---|---|
SubprocessResultsReporter () |
Métodos públicos | |
---|---|
void | close () |
TestSummary | getSummary () Permite que InvocationListener devuelva un resumen. |
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 ( FailureDescription failure) Informa una invocación incompleta 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. |
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 |
void | printEvent (String key, Object event) Ayudante para imprimir la clave del evento y luego el objeto json. |
void | setOutputTestLog (boolean outputTestLog) Establece si debemos o no dar salida a la prueba registrada o no. |
boolean | supportGranularResults () Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false. |
void | testAssumptionFailure ( TestDescription testId, String trace) Llamado cuando una prueba atómica marca que asume una condición que es falsa |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) Llamado cuando una prueba atómica marca que asume una condición que es falsa |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Alternativa a |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Informa el final de la ejecución de un caso de prueba individual. |
void | testFailed ( TestDescription testId, FailureDescription failure) Informa de la falla de un caso de prueba individual. |
void | testFailed ( TestDescription testId, String reason) Informa de la falla de un caso de prueba individual. |
void | testIgnored ( TestDescription testId) Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Proporciona el registro asociado o los datos de depuración de la invocación de prueba. |
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 time, runMetrics) testRunEnded (long time, 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 |
void | testRunFailed (String reason) La ejecución de la prueba de informes no se pudo completar debido a un error fatal. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Informa del inicio de una ejecución de prueba. |
void | testRunStarted (String runName, int testCount) Informa del inicio de una ejecución de prueba. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Informa del inicio de una ejecución de prueba. |
void | testRunStopped (long arg0) La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario. |
void | testStarted ( TestDescription testId, long startTime) Alternativa a |
void | testStarted ( TestDescription testId) Informa del inicio de un caso de prueba individual. |
Constructores públicos
SubprocessResultsReporter
public SubprocessResultsReporter ()
Métodos públicos
cerca
public void close ()
obtenerResumen
public TestSummary getSummary ()
Permite que InvocationListener devuelva un resumen.
Devoluciones | |
---|---|
TestSummary | Un TestSummary que resume la ejecución, o nulo |
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 (FailureDescription failure)
Informa una invocación incompleta debido a alguna condición de error.
Será llamado automáticamente por el marco TradeFederation.
Parámetros | |
---|---|
failure | FailureDescription : la FailureDescription que describe la causa de la falla |
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 : el ERROR(/Throwable) causa 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 |
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. |
imprimirEvento
public void printEvent (String key, Object event)
Ayudante para imprimir la clave del evento y luego el objeto json.
Parámetros | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Establece si debemos o no dar salida a la prueba registrada o no.
Parámetros | |
---|---|
outputTestLog | boolean |
supportGranularResults
public boolean supportGranularResults ()
Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.
Devoluciones | |
---|---|
boolean |
pruebaAsunciónFalla
public void testAssumptionFailure (TestDescription testId, String trace)
Llamado cuando una prueba atómica marca que asume una condición que es falsa
Parámetros | |
---|---|
testId | TestDescription : identifica la prueba |
trace | String : rastro de pila de falla |
pruebaAsunciónFalla
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Llamado cuando una prueba atómica marca que asume una condición que es falsa
Parámetros | |
---|---|
testId | TestDescription : identifica la prueba |
failure | FailureDescription : FailureDescription que describe el error y su contexto. |
pruebaTerminó
public void testEnded (TestDescription testId, long endTime,metrics)
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 | |
---|---|
testId | TestDescription : identifica la prueba |
endTime | long : la hora en que finalizó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
metrics | ERROR(/Map) de las métricas emitidas |
pruebaTerminó
public void testEnded (TestDescription testId,metrics)
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 | |
---|---|
testId | TestDescription : identifica la prueba |
metrics | ERROR(/Map) de las métricas emitidas |
prueba fallida
public void testFailed (TestDescription testId, FailureDescription failure)
Informa de la falla de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
Parámetros | |
---|---|
testId | TestDescription : identifica la prueba |
failure | FailureDescription : FailureDescription que describe el error y su contexto. |
prueba fallida
public void testFailed (TestDescription testId, String reason)
Informa de la falla de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
Parámetros | |
---|---|
testId | TestDescription : identifica la prueba |
reason | String : rastro de pila de falla |
prueba ignorada
public void testIgnored (TestDescription testId)
Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
Parámetros | |
---|---|
testId | TestDescription : identifica la prueba |
registro de prueba
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Proporciona el registro asociado o los datos de depuración de la invocación de prueba.
Debe llamarse antes deERROR(/ITestInvocationListener#invocationFailed(Throwable))
o ERROR(/ITestInvocationListener#invocationEnded(long))
El marco de TradeFederation llamará automáticamente a este método, proporcionando el registro del host y, si corresponde, el logcat del dispositivo.Parámetros | |
---|---|
dataName | String : un ERROR(/String) nombre descriptivo de los datos. por ejemplo, "device_logcat". Tenga en cuenta que dataName puede no ser único por invocación. es decir, los implementadores deben poder manejar múltiples llamadas con el mismo nombre de datos |
dataType | LogDataType : el LogDataType de los datos |
dataStream | InputStreamSource : el InputStreamSource de los datos. Los implementadores deben llamar a createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream resultante cuando se complete. Las personas que llaman deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog. |
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 time,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 | |
---|---|
time | long : tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics | 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 reason)
La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
Parámetros | |
---|---|
reason | String : ERROR(/String) que describe el motivo del error de ejecución. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Informa del inicio de una ejecución de prueba.
Parámetros | |
---|---|
runName | String : el nombre de la ejecución de prueba |
testCount | 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 runName, int testCount)
Informa del inicio de una ejecución de prueba.
Parámetros | |
---|---|
runName | String : el nombre de la ejecución de prueba |
testCount | int : número total de pruebas en ejecución de prueba |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Informa del inicio de una ejecución de prueba.
Parámetros | |
---|---|
runName | String : el nombre de la ejecución de prueba |
testCount | 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 ERROR(/System#currentTimeMillis()) |
testRunStopped
public void testRunStopped (long arg0)
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 | |
---|---|
arg0 | long : tiempo transcurrido informado por el dispositivo, en milisegundos |
pruebaEmpezó
public void testStarted (TestDescription testId, 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 | |
---|---|
testId | TestDescription : identifica la prueba |
startTime | long : la hora en que comenzó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
pruebaEmpezó
public void testStarted (TestDescription testId)
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 | |
---|---|
testId | TestDescription : identifica la prueba |