Esta página se ha traducido con Cloud Translation API.

Reenviador de resultados

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subclases directas conocidas

FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer

Reenviador de resultados filtrados	Variante de `ResultForwarder` que solo permite informar una lista de permitidos de `TestDescription` .
JarHostTest.HostTestListener	Oyente contenedor que reenvía todos los eventos excepto testRunStarted() y testRunEnded() al oyente integrado.
LogSaverResultForwarder	Un `ResultForwarder` para guardar registros con el protector de archivos global.
LogcatCrashResultForwarder	Oyente especial: en caso de fallas (el proceso de instrumentación falla), intentará extraer del logcat la falla y lo agregará al mensaje de falla asociado con la prueba.
PythonBinaryHostTest.PythonForwarder	Reenviador de resultados para reemplazar el nombre de la ejecución por el nombre binario.
Resultado y reenviador de registros	Reenviador de resultados y registros de eventos.
Reenviar resultados de intento	Una extensión de `ResultForwarder` que siempre envía a un número de intento determinado.
FragmentoMainResultForwarder	Un `ResultForwarder` que combina los resultados de invocaciones de prueba fragmentadas.
TestTimeoutEnforcer	Oyentes que permiten verificar el tiempo de ejecución de un caso de prueba determinado y fallarlo si supera un tiempo de espera determinado.

Subclases indirectas conocidas

GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Ayudante de clase para detectar el inicio y el final de la ejecución faltante.
ReintentarLogSaverResultForwarder	Reenviador que también se encarga de pasar el intento actual en el que nos encontramos.

Un ITestInvocationListener que reenvía los resultados de la invocación a una lista de otros oyentes.

Resumen

Constructores públicos
`ResultForwarder ( listeners)` `ResultForwarder ( listeners)` Cree un `ResultForwarder` .
`ResultForwarder ( ITestInvocationListener... listeners)` Constructor de argumentos de variable alternativa para `ResultForwarder` .

Constructores protegidos
`ResultForwarder ()` Cree un `ResultForwarder` con configuración de escucha diferida.

Métodos públicos
`TestSummary`	`getSummary ()` Permite que InvocationListener devuelva un resumen.
`void`	`invocationEnded (long elapsedTime)` Informa que la invocación ha finalizado, ya sea exitosamente 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`	`invocationSkipped ( SkipReason reason)` Informa una invocación como omitida
`void`	`invocationStarted ( IInvocationContext context)` Informa el inicio de la invocación de prueba.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Se llama cuando una prueba atómica indica que asume una condición que es falsa
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica indica 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 el error de un caso de prueba individual.
`void`	`testFailed ( TestDescription test, String trace)` Informa el error de un caso de prueba individual.
`void`	`testIgnored ( TestDescription test)` Se llama cuando no se va a 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 los datos de registro o depuración asociados de la invocación de prueba.
`void`	`testModuleEnded ()` Informa el final de la ejecución de un módulo.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Informa del comienzo de la ejecución de un módulo.
`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 prueba de informes no se pudo completar debido a un error descrito en `FailureDescription` .
`void`	`testRunFailed (String errorMessage)` La ejecución de 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 elapsedTime)` La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
`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.
`void`	`testStarted ( TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` donde también especificamos cuándo se inició la prueba, combinado con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para una medición precisa .
`void`	`testStarted ( TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos protegidos
	`getListeners ()` Obtenga la lista de oyentes.
`void`	`setListeners ( ITestInvocationListener... listeners)` Configure los oyentes después de la construcción.
`void`	`setListeners ( listeners)` `setListeners ( listeners)` Configure los oyentes después de la construcción.

Constructores públicos

Reenviador de resultados

public ResultForwarder ( listeners)

Cree un ResultForwarder .

Parámetros
`listeners`	: los `ITestInvocationListener` reales a los que reenviar los resultados

Reenviador de resultados

public ResultForwarder (ITestInvocationListener... listeners)

Constructor de argumentos de variable alternativa para ResultForwarder .

Parámetros
`listeners`	`ITestInvocationListener` : los `ITestInvocationListener` reales a los que reenviar los resultados

Constructores protegidos

Reenviador de resultados

protected ResultForwarder ()

Cree un ResultForwarder con configuración de escucha diferida. Diseñado únicamente para uso de subclases.

Métodos públicos

obtener resumen

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Devoluciones
`TestSummary`	Un `TestSummary` que resume la ejecución, o nulo

invocaciónFinalizada

public void invocationEnded (long elapsedTime)

Informa que la invocación ha finalizado, ya sea exitosamente o debido a alguna condición de error.

Será llamado automáticamente por el marco de TradeFederation.

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

invocación fallida

public void invocationFailed (FailureDescription failure)

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

Será llamado automáticamente por el marco de TradeFederation.

Parámetros
`failure`	`FailureDescription` : la `FailureDescription` que describe la causa del fallo.

invocación fallida

public void invocationFailed (Throwable cause)

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

Será llamado automáticamente por el marco de TradeFederation.

Parámetros
`cause`	`Throwable` : la causa `Throwable` del fallo.

invocación omitida

public void invocationSkipped (SkipReason reason)

Informa una invocación como omitida

Parámetros
`reason`	`SkipReason`

invocaciónIniciada

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco de 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

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
`test`	`TestDescription` : identifica la prueba.
`trace`	`String` : seguimiento de pila del error

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica indica 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.

pruebafinalizada

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` : la hora en que finalizó la prueba, medida a través de `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` de las métricas emitidas

pruebafinalizada

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 pueda haberse 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 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 el error y su contexto.

prueba fallida

public 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 del error

pruebaIgnorado

public void testIgnored (TestDescription test)

Se llama cuando no se va a ejecutar una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
`test`	`TestDescription` : identifica la prueba.

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.

Debe llamarse antes de ERROR(/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` : una `String` que describe el nombre 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 esté completo. 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 el final de la ejecución de un módulo.

módulo de prueba iniciado

public void testModuleStarted (IInvocationContext moduleContext)

Informa del 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: corredores basados en suite.

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

pruebaRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

prueba de ejecución fallida

public void testRunFailed (FailureDescription failure)

La ejecución de prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

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

prueba de ejecución fallida

public void testRunFailed (String errorMessage)

La ejecución de 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.

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo el mismo nombre de ejecución y el número de intento es de 0 a 3.

pruebaRunStarted

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

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo 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 mediante `System.currentTimeMillis()`

pruebaEjecutarDetenido

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 uso, considere eliminarlo

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

prueba omitida

public 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 intentar obtener una ejecución adecuada.

Parámetros
`test`	`TestDescription` : identifica la prueba.
`reason`	`SkipReason` : `SkipReason`

pruebaIniciada

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, combinado 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()`

pruebaIniciada

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. La interfaz anterior debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
`test`	`TestDescription` : identifica la prueba.

Métodos protegidos

obtener oyentes

protected  getListeners ()

Obtenga la lista de oyentes. Diseñado únicamente para uso de subclases.

Devoluciones
	La lista de `ITestInvocationListener` s.

establecer oyentes

protected void setListeners (ITestInvocationListener... listeners)

Configure los oyentes después de la construcción. Diseñado únicamente para uso de subclases.

Parámetros
`listeners`	`ITestInvocationListener` : los `ITestInvocationListener` reales a los que reenviar los resultados

establecer oyentes

protected void setListeners ( listeners)

Configure los oyentes después de la construcción. Diseñado únicamente para uso de subclases.

Parámetros
`listeners`	: los `ITestInvocationListener` reales a los que reenviar los resultados