Se usó la API de Cloud Translation para traducir esta página.

NombreMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Un agente de escucha para traducir métodos de prueba, clases y nombres de paquetes a medida que se informan los resultados.

Resumen

Constructores públicos
`NameMangleListener ( ITestInvocationListener listener)`

Métodos públicos
`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 (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`	`testAssumptionFailure ( TestDescription test, String trace)` Llamado cuando una prueba atómica marca que asume una condición que es falsa
`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, String trace)` Informa de la falla de un caso de prueba individual.
`void`	`testIgnored ( TestDescription test)` 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`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Informa el final de la ejecución de la prueba.
`void`	`testRunFailed (String errorMessage)` La ejecución de la prueba de informes no se pudo completar debido a un error fatal.
`void`	`testRunStarted (String runName, int testCount)` 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`	`testStarted ( TestDescription test)` Informa del inicio de un caso de prueba individual.

Métodos protegidos
`TestDescription`	`mangleTestId ( TestDescription test)` Este método se ejecuta en todos los `TestDescription` que se pasan a `testStarted(com.android.tradefed.result.TestDescription)` , `testFailed(com.android.tradefed.result.TestDescription, String)` y `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))` devoluciones de llamada.
`String`	`mangleTestRunName (String name)` Este método se ejecuta en todos los nombres de ejecución de prueba que se pasan a la devolución de llamada `testRunStarted(String, int)` .

Constructores públicos

NombreMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parámetros
`listener`	`ITestInvocationListener`

Métodos públicos

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 (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

pruebaAsunciónFalla

public void testAssumptionFailure (TestDescription test, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
`test`	`TestDescription` : identifica la prueba
`trace`	`String` : rastro de pila de falla

pruebaTerminó

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 se haya 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, 
                String trace)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`test`	`TestDescription` : identifica la prueba
`trace`	`String` : rastro de pila de falla

prueba ignorada

public void testIgnored (TestDescription test)

Se llama cuando no se 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 el registro asociado o los datos de depuración 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` : 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.

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`	: pares clave-valor notificados al final de una ejecución de prueba con `Metric` .

pruebaRunFailed

public void testRunFailed (String errorMessage)

La ejecución de la prueba de informes no se pudo completar debido a un error fatal.

Parámetros
`errorMessage`	`String` : `ERROR(/String)` que describe el motivo del error de ejecución.

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

testRunStopped

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 usar, considere eliminar

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

pruebaEmpezó

public void testStarted (TestDescription test)

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
`test`	`TestDescription` : identifica la prueba

Métodos protegidos

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Este método se ejecuta en todos los TestDescription que se pasan a testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) y ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) devoluciones de llamada. El método debe devolver una TestDescription posiblemente diferente que se pasará al ITestInvocationListener descendente que se especificó durante la construcción.

La implementación debe tener cuidado de no modificar la TestDescription original.

La implementación predeterminada pasa el identificador entrante sin modificar.

Parámetros
`test`	`TestDescription`

Devoluciones
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Este método se ejecuta en todos los nombres de ejecución de prueba que se pasan a la devolución de llamada testRunStarted(String, int) . El método debe devolver un nombre de ejecución de prueba posiblemente diferente que se pasará al ITestInvocationListener descendente que se especificó durante la construcción.

La implementación debe tener cuidado de no modificar el nombre de ejecución original.

La implementación predeterminada pasa el nombre de ejecución de prueba entrante sin modificar.

Parámetros
`name`	`String`

Devoluciones
`String`