ITestStorageClient

public interface ITestStorageClient

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


Interface para comunicação com o back-end do Android Test Storage. A interface contém métodos para criar e atualizar invocações e unidades de trabalho e fazer upload dos resultados do teste. Para criar ou atualizar unidades de trabalho ou resultados de testes, elas precisam pertencer a uma invocação criada por este cliente ou adicionada usando o método "addInvocation".

Resumo

Métodos públicos

abstract Invocation createInvocation(Invocation invocation)

Cria uma invocação no Test Storage usando os dados da invocação fornecida.

abstract Build createLocalBuild(Build localBuild)

Insira uma versão local no back-end.

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

Cria uma unidade de trabalho no Test Storage.

abstract ImmutableList<WorkUnit> createWorkUnits( workUnits)

Cria todas as unidades de trabalho em uma lista fornecida no TestStorage.

abstract File fetchTestArtifact(String invocationId, String resourceId)

Busca e retorna o arquivo de artefato de teste solicitado.

abstract void finalizeTestResults()

Aguarde até que todos os resultados do teste sejam enviados.

abstract Invocation getInvocation(String invocationId)

Retorna uma invocação com o ID fornecido.

abstract BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

Retorna um artefato de teste que corresponde à invocação e ao ID do recurso fornecidos.

abstract WorkUnit getWorkUnit(String workUnitId)

Retorna uma unidade de trabalho que corresponde ao ID fornecido.

abstract TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

Pesquisa e lista todos os artefatos de teste que correspondem ao tipo fornecido.

abstract Invocation updateInvocation(Invocation invocation)

Atualiza uma invocação no Test Storage usando os dados da invocação fornecida.

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

Atualiza o artefato fornecido.

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

Atualiza o artefato fornecido e faz upload do conteúdo fornecido.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

Atualiza uma unidade de trabalho fornecida no Test Storage.

abstract void uploadAssociations( associations, int poolSize)

Faz upload de associações entre registros e testes/unidades de trabalho.

abstract void uploadResult(TestResult result)

Faça upload do resultado do teste fornecido para o Test Storage.

Métodos públicos

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

Cria uma invocação no Test Storage usando os dados da invocação fornecida.

Parâmetros
invocation Invocation: descreve a invocação a ser criada.

Retorna
Invocation invocação criada no Test Storage.

Gera
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Insira uma build local no back-end.

Parâmetros
localBuild Build: descrição do build local

Retorna
Build um Build

Gera
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Cria uma unidade de trabalho no Test Storage.

Parâmetros
workUnit WorkUnit: descreve a unidade de trabalho a ser criada.

Retorna
WorkUnit uma nova unidade de trabalho.

Gera
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Cria todas as unidades de trabalho em uma lista fornecida no TestStorage.

Parâmetros
workUnits : lista de unidades de trabalho a serem criadas.

Retorna
ImmutableList<WorkUnit> uma lista de unidades de trabalho criadas.

Gera
IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

Busca e retorna o arquivo de artefato de teste solicitado.

Parâmetros
invocationId String

resourceId String

Retorna
File

finalizeTestResults

public abstract void finalizeTestResults ()

Aguarde até que todos os resultados do teste sejam enviados.

getInvocation

public abstract Invocation getInvocation (String invocationId)

Retorna uma invocação com o ID fornecido.

Parâmetros
invocationId String: - ID da invocação a ser retornada.

Retorna
Invocation

Gera
- se a invocação fornecida não for encontrada ou se houver um erro na comunicação com o back-end.

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Retorna um artefato de teste que corresponde à invocação e ao ID do recurso fornecidos.

Parâmetros
invocationId String

resourceId String

Retorna
BuildArtifactMetadata

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

Retorna uma unidade de trabalho que corresponde ao ID fornecido.

Parâmetros
workUnitId String: - ID da unidade de trabalho.

Retorna
WorkUnit

Gera
- se a unidade de trabalho fornecida não for encontrada ou houver um erro ao se comunicar com os serviços de back-end.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Pesquisa e lista todos os artefatos de teste que correspondem ao tipo fornecido.

Parâmetros
invocationId String

artifactType String

Retorna
TestArtifactListResponse

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

Atualiza uma invocação no Test Storage usando os dados da invocação fornecida.

Parâmetros
invocation Invocation: - invocação com dados atualizados.

Retorna
Invocation uma invocação atualizada.

Gera
IOException

updateTestArtifact

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

Atualiza o artefato fornecido. Esse método só atualiza a associação e não modifica o conteúdo. Ao chamar esse método, forneça o ID de invocação original, o ID da unidade de trabalho e o ID do resultado do teste como argumentos. Coloque a nova unidade de trabalho e o ID do resultado do teste no objeto BuildArtifactMetadata. Quando o ID da unidade de trabalho e/ou o resultado do teste não são usados na associação, eles devem ser definidos como uma string vazia ("").

Parâmetros
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

legacyId long

Retorna
BuildArtifactMetadata

updateTestArtifact

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

Atualiza o artefato fornecido e faz upload do conteúdo fornecido. Ao fazer upload de conteúdo, não é possível atualizar os dados de associação. Não modifique o ID da unidade de trabalho e o ID do resultado do teste já definidos no argumento BuildArtifactMetadata.

Parâmetros
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

Retorna
BuildArtifactMetadata

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Atualiza uma unidade de trabalho fornecida no Test Storage.

Parâmetros
workUnit WorkUnit: - unidade de trabalho a ser atualizada.

Retorna
WorkUnit unidade de trabalho atualizada.

Gera
IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

Faz upload de associações entre registros e testes/unidades de trabalho. As associações permitem que o Android Test Storage acompanhe qual teste produziu um registro.

Parâmetros
associations : uma lista de arquivos de registro e associações.

poolSize int: o tamanho do pool de workers usado para upload paralelo. 0 para nenhum upload paralelo.

Gera
IOException

uploadResult

public abstract void uploadResult (TestResult result)

Faça upload do resultado do teste fornecido para o Test Storage. O resultado do teste precisa fazer parte de uma invocação criada anteriormente.

Parâmetros
result TestResult: - resultado a ser enviado.

Gera
IOException