ITestStorageClient

public interface ITestStorageClient

com.google.android.tradefed.result.teststorage.ITestStorageClient


Es una interfaz para comunicarse con el backend de Android Test Storage. La interfaz contiene métodos para crear y actualizar invocaciones y unidades de trabajo, y para subir resultados de pruebas. Para crear o actualizar unidades de trabajo o resultados de pruebas, deben pertenecer a una invocación que haya creado este cliente o que se haya agregado con el método addInvocation.

Resumen

Métodos públicos

abstract Invocation createInvocation(Invocation invocation)

Crea una invocación en Test Storage con los datos de la invocación proporcionada.

abstract Build createLocalBuild(Build localBuild)

Inserta una compilación local en el backend.

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

Crea una unidad de trabajo en Test Storage.

abstract ImmutableList<WorkUnit> createWorkUnits( workUnits)

Crea todas las unidades de trabajo en una lista proporcionada en TestStorage.

abstract File fetchTestArtifact(String invocationId, String resourceId)

Recupera y devuelve el archivo de artefacto de prueba solicitado.

abstract void finalizeTestResults()

Espera hasta que se suban todos los resultados de las pruebas.

abstract Invocation getInvocation(String invocationId)

Devuelve una invocación que tiene el ID de invocación proporcionado.

abstract BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

Devuelve un artefacto de prueba que coincide con el ID de recurso y la invocación proporcionados.

abstract WorkUnit getWorkUnit(String workUnitId)

Devuelve una unidad de trabajo que coincide con el ID proporcionado.

abstract TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

Busca y enumera todos los artefactos de prueba que coinciden con el tipo proporcionado.

abstract Invocation updateInvocation(Invocation invocation)

Actualiza una invocación en Test Storage con los datos de la invocación proporcionada.

abstract BuildArtifactMetadata updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)

Actualiza el artefacto proporcionado.

abstract BuildArtifactMetadata updateTestArtifact(BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)

Actualiza el artefacto proporcionado y sube el contenido proporcionado.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

Actualiza una unidad de trabajo proporcionada en Test Storage.

abstract void uploadAssociations( associations, int poolSize)

Sube asociaciones entre registros y pruebas o unidades de trabajo.

abstract void uploadResult(TestResult result)

Sube el resultado de la prueba proporcionado a Test Storage.

Métodos públicos

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

Crea una invocación en Test Storage con los datos de la invocación proporcionada.

Parámetros
invocation Invocation: Describe la invocación que se creará.

Muestra
Invocation Es la invocación que se creó en Test Storage.

Arroja
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Inserta una compilación local en el backend.

Parámetros
localBuild Build: Descripción de la compilación local

Muestra
Build un Build

Arroja
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Crea una unidad de trabajo en Test Storage.

Parámetros
workUnit WorkUnit: Describe la unidad de trabajo que se creará.

Muestra
WorkUnit una nueva unidad de trabajo.

Arroja
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Crea todas las unidades de trabajo en una lista proporcionada en TestStorage.

Parámetros
workUnits : Es la lista de unidades de trabajo que se crearán.

Muestra
ImmutableList<WorkUnit> Es una lista de las unidades de trabajo que se crearon.

Arroja
IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

Recupera y devuelve el archivo de artefacto de prueba solicitado.

Parámetros
invocationId String

resourceId String

Muestra
File

finalizeTestResults

public abstract void finalizeTestResults ()

Espera hasta que se suban todos los resultados de las pruebas.

getInvocation

public abstract Invocation getInvocation (String invocationId)

Devuelve una invocación que tiene el ID de invocación proporcionado.

Parámetros
invocationId String: ID de la invocación que se devolverá.

Muestra
Invocation

Arroja
- Si no se encuentra la invocación proporcionada o si hay un error de comunicación con el backend

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Devuelve un artefacto de prueba que coincide con el ID de recurso y la invocación proporcionados.

Parámetros
invocationId String

resourceId String

Muestra
BuildArtifactMetadata

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

Devuelve una unidad de trabajo que coincide con el ID proporcionado.

Parámetros
workUnitId String: Es el ID de la unidad de trabajo.

Muestra
WorkUnit

Arroja
- Si no se encuentra la unidad de trabajo proporcionada o si hay un error de comunicación con los servicios de backend

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Busca y enumera todos los artefactos de prueba que coinciden con el tipo proporcionado.

Parámetros
invocationId String

artifactType String

Muestra
TestArtifactListResponse

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

Actualiza una invocación en Test Storage con los datos de la invocación proporcionada.

Parámetros
invocation Invocation: Es la invocación con datos actualizados.

Muestra
Invocation una invocación actualizada.

Arroja
IOException

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (String invocationId, 
                String workUnitId, 
                String testResultId, 
                BuildArtifactMetadata artifact, 
                long legacyId)

Actualiza el artefacto proporcionado. Este método solo actualiza la asociación y no modifica el contenido. Cuando llames a este método, proporciona el ID de invocación original, el ID de unidad de trabajo y el ID del resultado de la prueba como argumentos. Coloca el nuevo ID de unidad de trabajo y resultado de la prueba en el objeto BuildArtifactMetadata. Cuando el ID de la unidad de trabajo o el resultado de la prueba no se usan en la asociación, se deben establecer como una cadena vacía ("").

Parámetros
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

legacyId long

Muestra
BuildArtifactMetadata

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

Actualiza el artefacto proporcionado y sube el contenido proporcionado. Cuando se sube contenido, no es posible actualizar los datos de asociación. No modifiques el ID de la unidad de trabajo ni el ID del resultado de la prueba que ya se establecieron en el argumento BuildArtifactMetadata.

Parámetros
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

Muestra
BuildArtifactMetadata

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Actualiza una unidad de trabajo proporcionada en Test Storage.

Parámetros
workUnit WorkUnit: Es la unidad de trabajo que se actualizará.

Muestra
WorkUnit Es la unidad de trabajo actualizada.

Arroja
IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

Sube asociaciones entre registros y pruebas o unidades de trabajo. Las asociaciones permiten que Android Test Storage haga un seguimiento de qué prueba produjo un registro.

Parámetros
associations : Es una lista de archivos de registro y sus asociaciones.

poolSize int: Es el tamaño del grupo de trabajadores que se usa para la carga paralela. 0 para no realizar cargas paralelas.

Arroja
IOException

uploadResult

public abstract void uploadResult (TestResult result)

Sube el resultado de la prueba proporcionado a Test Storage. El resultado de la prueba debe ser parte de una invocación creada anteriormente.

Parámetros
result TestResult: Es el resultado que se subirá.

Arroja
IOException