BasePostProcessor
public
abstract
class
BasePostProcessor
extends Object
implements
IPostProcessor
Objeto java.lang. | |
↳ | com.android.tradefed.postprocessor.BasePostProcessor |
El IPostProcessor
base que debe extender cada implementación. Asegúrate de que la publicación
de procesamiento de datos se llama antes
que los generadores de informes de resultados finales.
Resumen
Constructores públicos | |
---|---|
BasePostProcessor()
|
Métodos públicos | |
---|---|
final
ITestInvocationListener
|
init(ITestInvocationListener listener)
Paso de inicialización del procesador posterior. |
final
void
|
invocationEnded(long elapsedTime)
Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado. |
final
void
|
invocationFailed(FailureDescription failure)
Informa una invocación incompleta debido a alguna condición de error. |
final
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 |
final
void
|
invocationStarted(IInvocationContext context)
Objetos de escucha de invocación para reenvíos |
final
boolean
|
isDisabled()
Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). |
final
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 Actualiza la asignación de registro a prueba. |
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
Implementa este método para agregar métricas y registros en todas las pruebas. |
abstract
|
processRunMetricsAndLogs(
Implementa este método para generar un conjunto de métricas nuevas a partir de las métricas existentes y los registros del sistema operativo. |
|
processTestMetricsAndLogs(TestDescription testDescription,
Implementa este método para el procesamiento posterior de las métricas y los registros de cada prueba. |
final
void
|
setLogSaver(ILogSaver logSaver)
Establece |
void
|
setUp()
Anula este método en los procesadores posteriores para inicializar antes de que se ejecute la prueba. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Se llama cuando una prueba atómica marca que asume una condición falsa. |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que asume una condición falsa. |
final
void
|
testEnded(TestDescription test, long endTime,
Alternativa a |
final
void
|
testEnded(TestDescription test,
Informa el final de la ejecución de un caso de prueba individual. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Informa el error de un caso de prueba individual. |
final
void
|
testFailed(TestDescription test, String trace)
Informa el error de un caso de prueba individual. |
final
void
|
testIgnored(TestDescription test)
Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar. |
final
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Usa este método para registrar un archivo de la implementación de PostProcessor. |
final
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Se llama cuando se guarda el registro de pruebas. |
final
void
|
testModuleEnded()
Informa el final de la ejecución de un módulo. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Informa el comienzo de la ejecución de un módulo. |
final
void
|
testRunEnded(long elapsedTime,
Informa el final de la ejecución de la prueba. |
final
void
|
testRunFailed(FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a un error que describe |
final
void
|
testRunFailed(String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave. |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Informa el inicio de una ejecución de prueba. |
final
void
|
testRunStarted(String runName, int testCount)
Devoluciones de llamada de ejecución de prueba |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Informa el inicio de una ejecución de prueba. |
final
void
|
testRunStopped(long elapsedTime)
La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. |
final
void
|
testStarted(TestDescription test, long startTime)
Es una alternativa a |
final
void
|
testStarted(TestDescription test)
Devoluciones de llamada de casos de prueba |
Métodos protegidos | |
---|---|
void
|
cleanUp()
|
MetricMeasurement.DataType
|
getMetricType()
Anula este método para cambiar el tipo de métrica si es necesario. |
String
|
getRunName()
|
Constructores públicos
BasePostProcessor
public BasePostProcessor ()
Métodos públicos
init
public final ITestInvocationListener init (ITestInvocationListener listener)
Paso de inicialización del procesador posterior. Se debe llamar antes de cualquiera de las pruebas. devoluciones de llamada.
Parámetros | |
---|---|
listener |
ITestInvocationListener |
Muestra | |
---|---|
ITestInvocationListener |
invocaciónFinalizada
public final 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 final 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 final 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 final void invocationStarted (IInvocationContext context)
Objetos de escucha de invocación para reenvíos
Parámetros | |
---|---|
context |
IInvocationContext : Información sobre la invocación |
Inhabilitado
public final boolean isDisabled ()
Muestra el valor True si se inhabilita el objeto completo (se omite la configuración y la eliminación). De lo contrario, el valor es falso.
Muestra | |
---|---|
boolean |
Asociación de registro
public final 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.
Actualiza la asignación de registro a prueba. Si se llama a este método durante una prueba, el registro pertenece a la prueba; de lo contrario, será un registro de ejecución.
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. |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Implementa este método para agregar métricas y registros en todas las pruebas. Métricas que provienen de este método se informará como métricas de ejecución. Solo las métricas recién generadas se deben y un nombre de clave único (no se permite ningún conflicto con las claves existentes).
Parámetros | |
---|---|
allTestMetrics |
ListMultimap : Es un HashMultimap que almacena las métricas de cada prueba agrupadas por métrica.
y nombres de usuario. |
allTestLogs |
: Es un mapa en el que se almacena el mapa de cada prueba de archivos de registro protegidos por sus nombres de datos.
usando el TestDescription de cada prueba como claves. |
Muestra | |
---|---|
|
El conjunto de métricas recién generadas de todas las métricas de prueba. |
processRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
Implementa este método para generar un conjunto de métricas nuevas a partir de las métricas existentes y los registros del sistema operativo. Solo se deben mostrar las métricas recién generadas y con un nombre de clave único (sin se permite la colisión con claves existentes).
Parámetros | |
---|---|
rawMetrics |
: Es el conjunto de métricas sin procesar disponibles para la ejecución. |
runLogs |
: Es el conjunto de archivos de registro de la ejecución de prueba. |
Muestra | |
---|---|
|
El conjunto de métricas recién generadas a partir de las métricas de ejecución. |
procesoTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Implementa este método para el procesamiento posterior de las métricas y los registros de cada prueba. Solo los nuevos las métricas generadas y con un nombre de clave único (sin colisión con los valores claves).
Parámetros | |
---|---|
testDescription |
TestDescription : Es el objeto TestDescription que describe la prueba. |
testMetrics |
: Es el conjunto de métricas de la prueba. |
testLogs |
: Es el conjunto de archivos que se registró durante la prueba. |
Muestra | |
---|---|
|
El conjunto de métricas recién generadas a partir de las métricas de prueba. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
Establece ILogSaver
para permitir que el implementador guarde archivos.
Parámetros | |
---|---|
logSaver |
ILogSaver : el ILogSaver |
Configuración
public void setUp ()
Anula este método en los procesadores posteriores para inicializar antes de que se ejecute la prueba.
ErrordeAsuncióndeprueba
public final void testAssumptionFailure (TestDescription test, String trace)
Se llama cuando una prueba atómica marca que asume una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
trace |
String : seguimiento de pila de las fallas |
ErrordeAsuncióndeprueba
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que asume una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
pruebaFinalizada
public final void testEnded (TestDescription test, long endTime,testMetrics)
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 mediciones precisas.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
endTime |
long : La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis() |
testMetrics |
: Una ERROR(/Map) de las métricas emitidas |
pruebaFinalizada
public final 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 completó correctamente. También muestra cualquier par clave-valor.
métricas que podrían haberse emitido durante la ejecución del caso de prueba.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
testMetrics |
: Una ERROR(/Map) de las métricas emitidas |
Prueba con errores
public final void testFailed (TestDescription test, FailureDescription failure)
Informa el error 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 |
Prueba con errores
public final void testFailed (TestDescription test, String trace)
Informa el error de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
trace |
String : seguimiento de pila de las fallas |
pruebaIgnorada
public final void testIgnored (TestDescription test)
Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
Registro de prueba
public final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Usa este método para registrar un archivo de la implementación de PostProcessor.
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 sea
presente y accesible hasta que se complete el método testLog. |
testLogSaved
public final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Se llama cuando se guarda el registro de pruebas.
Debe usarse en lugar de ITestInvocationListener#testLog(String, LogDataType,
InputStreamSource)
.
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 |
logFile |
LogFile : El LogFile que contiene los metadatos del archivo guardado. |
módulodepruebafinalizado
public final void testModuleEnded ()
Informa el final de la ejecución de un módulo.
MódulodepruebaIniciado
public final 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 final 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 final 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 final void testRunFailed (String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave.
Parámetros | |
---|---|
errorMessage |
String : String que describe el motivo de la falla de ejecución |
pruebaRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Informa el inicio de una ejecución de prueba.
Parámetros | |
---|---|
runName |
String : Es el nombre de la ejecución de prueba. |
testCount |
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 tryNumber tiene un índice 0 y debería aumentarse cada vez
se ejecuta una nueva ejecución. p.ej., Se vuelve a intentar una prueba detallada 3 veces; debería tener 4 en total
se ejecuta con el mismo runName y tryNumber del 0 al 3. |
pruebaRunStarted
public final void testRunStarted (String runName, int testCount)
Devoluciones de llamada de ejecución de prueba
Parámetros | |
---|---|
runName |
String : Es el nombre de la ejecución de prueba. |
testCount |
int : Cantidad total de pruebas en la ejecución de prueba |
pruebaRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Informa el inicio de una ejecución de prueba.
Parámetros | |
---|---|
runName |
String : Es el nombre de la ejecución de prueba. |
testCount |
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() . |
pruebaRundetenida
public final void testRunStopped (long elapsedTime)
La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario.
PENDIENTE: Actualmente sin uso, te recomendamos que lo quites
Parámetros | |
---|---|
elapsedTime |
long : Es el tiempo transcurrido informado por el dispositivo en milisegundos. |
pruebaOmitir
public final void testSkipped (TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. Se intentará volver a realizar estas pruebas para que se ejecute correctamente.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
reason |
SkipReason : SkipReason |
Iniciodeprueba
public final void testStarted (TestDescription test, long startTime)
Es una alternativa a testStarted(com.android.tradefed.result.TestDescription)
, donde también especificamos cuándo se realizó la prueba.
comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para obtener una medición precisa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
startTime |
long : Es la hora en que comenzó la prueba, medida mediante System.currentTimeMillis() . |
Iniciodeprueba
public final void testStarted (TestDescription test)
Devoluciones de llamada de casos de prueba
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
Métodos protegidos
Limpieza
protected void cleanUp ()
getMetricType
protected MetricMeasurement.DataType getMetricType ()
Anula este método para cambiar el tipo de métrica si es necesario. De forma predeterminada, la métrica está configurada en el tipo de datos procesados.
Muestra | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
Muestra | |
---|---|
String |