ResultDBReporter

public class ResultDBReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
↳	com.android.tradefed.result.resultdb.ResultDBReporter

---

Generador de informes de resultados que sube los resultados de las pruebas a ResultDB.

Resumen

Constructores públicos
ResultDBReporter()

Métodos públicos
TestSummary	getSummary() Permite que InvocationListener devuelva un resumen.
void	invocationEnded(long elapsedTime) Informa que la invocación finalizó, ya sea de forma correcta 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 que se omitió una invocación
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 un caso de prueba, pero no es posible hacerlo en la devolución de llamada directa de testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
void	setConfiguration(IConfiguration configuration) Inyecta el IConfiguration en uso.
void	setLogSaver(ILogSaver logSaver) Establece el ILogSaver para permitir que el implementador guarde archivos.
boolean	supportGranularResults() Muestra True si el generador de informes admite resultados detallados y False en caso contrario.
void	testAssumptionFailure(TestDescription test, String trace) Se llama cuando una prueba atómica marca que supone una condición falsa.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Se llama cuando una prueba atómica marca que supone una condición falsa.
void	testEnded(TestDescription test, long endTime, testMetrics) Es una alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente.
void	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 ejecutará una prueba, por lo general, 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 el inicio de la ejecución de un módulo.
void	testRunEnded(long elapsedTimeMillis, runMetrics) Informa el final de la ejecución de prueba.
void	testRunFailed(FailureDescription failure) No se pudo completar la ejecución de prueba de informes debido a una falla que describe FailureDescription.
void	testRunFailed(String errorMessage) No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.
void	testRunStarted(String runName, int testCount, int attemptNumber) Informa el inicio de una ejecución de prueba.
void	testRunStarted(String runName, int testCount) Informa el inicio de una ejecución de prueba.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Informa el inicio de una ejecución de prueba.
void	testRunStopped(long elapsedTime) La ejecución de 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 no suele esperarse.
void	testStarted(TestDescription test, long startTime) Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), en la que también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para obtener una medición precisa.
void	testStarted(TestDescription test) Informa el inicio de un caso de prueba individual.

Constructores públicos

ResultDBReporter

public ResultDBReporter ()

Métodos públicos

getSummary

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Muestra
TestSummary	Un TestSummary que resume la ejecución o es nulo

invocationEnded

public void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a alguna condición de error.

El framework de TradeFederation lo llamará automáticamente.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

El framework de TradeFederation lo llamará automáticamente.

Parámetros
failure	FailureDescription: El FailureDescription que describe la causa de la falla

invocationFailed

public void invocationFailed (Throwable cause)

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

El framework de TradeFederation lo llamará automáticamente.

Parámetros
cause	Throwable: Es la causa Throwable de la falla.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que se omitió una invocación

Parámetros
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

El framework de TradeFederation lo llamará automáticamente. Los generadores de informes deben anular este método para admitir informes de varios dispositivos.

Parámetros
context	IInvocationContext: Información sobre la invocación

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con un caso de prueba, pero no es posible hacerlo en la devolución de llamada directa de testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Por lo tanto, 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: Es el LogFile que se registró antes y debe estar asociado con el caso de prueba.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inyecta el IConfiguration en uso.

Parámetros
configuration	IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Establece ILogSaver para permitir que el implementador guarde archivos.

Parámetros
logSaver	ILogSaver: el ILogSaver

supportGranularResults

public boolean supportGranularResults ()

Muestra True si el generador de informes admite resultados detallados y False en caso contrario.

Muestra
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica marca que supone una condición falsa.

Parámetros
test	TestDescription: Identifica la prueba.
trace	String: seguimiento de pila de la falla

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica marca que supone una condición falsa.

Parámetros
test	TestDescription: Identifica la prueba.
failure	FailureDescription: FailureDescription que describe la falla y su contexto.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Es una 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 una medición precisa.

Parámetros
test	TestDescription: Identifica la prueba.
endTime	long: Es la hora en la que finalizó la prueba, medida a través de System.currentTimeMillis().
testMetrics	: Un ERROR(/Map) de las métricas emitidas

testEnded

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 se aprobó. También muestra cualquier métrica de par 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

testFailed

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 la falla y su contexto.

testFailed

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 de la falla

testIgnored

public void testIgnored (TestDescription test)

Se llama cuando no se ejecutará una prueba, por lo general, porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
test	TestDescription: Identifica la prueba.

testLog

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 que a ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o a ERROR(/ITestInvocationListener#invocationEnded(long)).

El framework de 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: Un nombre descriptivo String de los datos, p. ej., "device_logcat". Nota: Es posible que dataName no sea único por invocación. Es decir, los implementadores deben poder controlar varias llamadas con el mismo dataName.
dataType	LogDataType: El LogDataType de los datos
dataStream	InputStreamSource: Es 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 terminen. Los emisores 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.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa el inicio 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 suites.

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa el final de la ejecución de prueba.

Parámetros
elapsedTimeMillis	long: Tiempo transcurrido informado por el dispositivo, en milisegundos
runMetrics	: Son los pares clave-valor que se informan al final de una ejecución de prueba.

testRunFailed

public void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de informes debido a una falla que describe FailureDescription.

Parámetros
failure	FailureDescription: FailureDescription que describe la falla y su contexto.

testRunFailed

public void testRunFailed (String errorMessage)

No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.

Parámetros
errorMessage	String: String que describe el motivo de la falla de ejecución.

testRunStarted

public 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: Es la cantidad total de pruebas en la ejecución de prueba.
attemptNumber	int: Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va de 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa el inicio de una ejecución de prueba.

Parámetros
runName	String: Es el nombre de la ejecución de prueba.
testCount	int: Es la cantidad total de pruebas en la ejecución de prueba.

testRunStarted

public 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: Es la cantidad total de pruebas en la ejecución de prueba.
attemptNumber	int: Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va de 0 a 3.
startTime	long: Es la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis().

testRunStopped

public void testRunStopped (long elapsedTime)

La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que no suele esperarse. Se intentará volver a realizar estas pruebas para obtener una ejecución adecuada.

Parámetros
test	TestDescription: Identifica la prueba.
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Es una alternativa a testStarted(com.android.tradefed.result.TestDescription), en la que también especificamos cuándo se inició la prueba, combinada 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 a través de System.currentTimeMillis().

testStarted

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. Interfaz más antigua, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test	TestDescription: Identifica la prueba.