ShardListener
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Objeto | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.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.
Resumen
Constructores públicos | |
---|---|
ShardListener ( ITestInvocationListener main) Crea un |
Métodos públicos | |
---|---|
getUnderlyingResultReporter () | |
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 | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false. |
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 | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
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 |
void | testRunFailed (String failureMessage) 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, long startTime) Informa del inicio de una ejecución de prueba. |
Constructores públicos
ShardListener
public ShardListener (ITestInvocationListener main)
Crea un ShardListener
.
Parámetros | |
---|---|
main | ITestInvocationListener : el ITestInvocationListener los resultados deben ser reenviados. Para evitar colisiones con otros ShardListener s, este objeto se sincronizará en main al reenviar los resultados. Y los resultados solo se enviarán una vez que se complete el fragmento de invocación. |
Métodos públicos
obtenerReportero de resultados subyacentes
publicgetUnderlyingResultReporter ()
Devoluciones | |
---|---|
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 sólida.
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. |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
Parámetros | |
---|---|
enableGranularResults | boolean |
supportGranularResults
public boolean supportGranularResults ()
Devuelve True si el reportero admite resultados granulares; de lo contrario, devuelve false.
Devoluciones | |
---|---|
boolean |
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. |
testLogSaved
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parámetros | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
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 | 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 failureMessage)
La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
Parámetros | |
---|---|
failureMessage | String : ERROR(/String) que describe el motivo del error de ejecución. |
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 ERROR(/System#currentTimeMillis()) |