ShardListener
public
class
ShardListener
extends CollectingTestListener
implements
ISupportGranularResults
Objeto java.lang. | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.engager.ShardListener |
Un ITestInvocationListener
que recopila los resultados de un fragmento de invocación (también conocido como
división de invocación para ejecutarse en múltiples recursos en paralelo) y los reenvía a otro
objeto de escucha.
Resumen
Constructores públicos | |
---|---|
ShardListener(ITestInvocationListener main)
Crea un elemento |
Métodos públicos | |
---|---|
|
getUnderlyingResultReporter()
|
void
|
invocationEnded(long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado. |
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
|
invocationSkipped(SkipReason reason)
Informa una invocación como omitida |
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 estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo
así que en el |
void
|
setSupportGranularResults(boolean enableGranularResults)
|
boolean
|
supportGranularResults()
Muestra el valor True si el informante admite resultados detallados. De lo contrario, muestra false. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Proporciona los datos de registro o depuración asociados de la invocación de prueba. |
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
|
void
|
testModuleEnded()
Informa el final de la ejecución de un módulo. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Informa el comienzo de la ejecución de un módulo. |
void
|
testRunEnded(long elapsedTime,
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 |
void
|
testRunFailed(String failureMessage)
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, long startTime)
Informa el inicio de una ejecución de prueba. |
Constructores públicos
ShardListener
public ShardListener (ITestInvocationListener main)
Crea un elemento ShardListener
.
Parámetros | |
---|---|
main |
ITestInvocationListener : Es el ITestInvocationListener al que se deben reenviar los resultados. Para evitar
colisiones con otros ShardListener , este objeto se sincronizará en
main cuando reenvías resultados. Y los resultados solo se enviarán cuando
se completa el fragmento de invocación. |
Métodos públicos
getUnderlyingResultReporter.
publicgetUnderlyingResultReporter ()
Muestra | |
---|---|
|
invocaciónFinalizada
public void invocationEnded (long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.
Se llamará automáticamente a través del marco TradeFederation.
Parámetros | |
---|---|
elapsedTime |
long : El tiempo transcurrido de la invocación en ms |
Error de invocación
public void invocationFailed (FailureDescription failure)
Informa una invocación incompleta debido a alguna condición de error.
Se llamará automáticamente a través del marco TradeFederation.
Parámetros | |
---|---|
failure |
FailureDescription : Es el FailureDescription que describe la causa de la falla. |
Error de invocación
public void invocationFailed (Throwable cause)
Informa una invocación incompleta debido a alguna condición de error.
Se llamará automáticamente a través del marco TradeFederation.
Parámetros | |
---|---|
cause |
Throwable : Es la causa Throwable de la falla. |
se omitió el proceso de invocación
public void invocationSkipped (SkipReason reason)
Informa una invocación como omitida
Parámetros | |
---|---|
reason |
SkipReason |
iniciación de invocación
public void invocationStarted (IInvocationContext context)
Informa el inicio de la invocación de prueba.
Se llamará automáticamente a través del marco TradeFederation. Los reporteros deben anular este método para admitir informes de varios 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 estrechamente asociado con casos de prueba, pero la oportunidad de hacerlo
así que en el testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
directo
no es posible realizar la devolución de llamada. Esta devolución de llamada permite proporcionar una asociación sólida
de forma explícita.
Parámetros | |
---|---|
dataName |
String : Es 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 |
asistenciaGranularResults
public boolean supportGranularResults ()
Muestra el valor True si el informante admite resultados detallados. De lo contrario, muestra false.
Muestra | |
---|---|
boolean |
Registro de prueba
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Proporciona los datos de registro o depuración asociados de la invocación de prueba.
Se debe llamar antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable))
o
ERROR(/ITestInvocationListener#invocationEnded(long))
El framework TradeFederation llamará automáticamente a este método y proporcionará el registro del host. y, si corresponde, el logcat del dispositivo.
Parámetros | |
---|---|
dataName |
String : Es un nombre descriptivo String de los datos. p.ej., “device_logcat”. Nota
dataName no puede ser único por invocación. es decir, los implementadores deben poder manejar
varias llamadas con el mismo dataName |
dataType |
LogDataType : el LogDataType de los datos |
dataStream |
InputStreamSource : el InputStreamSource de los datos Los implementadores deben llamar
createInputStream para comenzar a leer los datos y asegurarse de cerrar el
InputStream cuando se complete Los emisores 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 |
módulodepruebafinalizado
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 paquetes.
Parámetros | |
---|---|
moduleContext |
IInvocationContext : Es el IInvocationContext del módulo. |
pruebaRunfinalizada
public void testRunEnded (long elapsedTime,runMetrics)
Informa el final de la ejecución de la prueba. FIXME: No podemos tener dos mapas<> con diferentes tipos, por lo que aquí tenemos que usar HashMap.
Parámetros | |
---|---|
elapsedTime |
long : Es el tiempo transcurrido informado por el dispositivo en milisegundos. |
runMetrics |
: Son pares clave-valor que se informan al final de una ejecución de prueba con Metric . |
Error de ejecución de prueba
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 failureMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave.
Parámetros | |
---|---|
failureMessage |
String : String que describe el motivo de la falla de ejecución |
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 : Cantidad total de pruebas en la ejecución de prueba |
attemptNumber |
int : Número de pedido, que identifica los diferentes intentos del mismo runName
que se ejecutan varias veces. El valor de intentNumber tiene un índice 0 y debería aumentarse cada vez que se genera un
una nueva carrera. p.ej., Se vuelve a intentar una prueba detallada 3 veces, por lo que debería tener 4 ejecuciones en total
con el mismo runName e tryNumber del 0 al 3. |
startTime |
long : Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis() . |