ITestStorageClient

public interface ITestStorageClient

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


Interfaccia per comunicare con il backend di Android Test Storage. L'interfaccia contiene metodi per creare e aggiornare chiamate e unità di lavoro e caricare i risultati dei test. Per creare o aggiornare unità di lavoro o risultati dei test, questi devono appartenere a un'invocazione creata da questo client oppure l'invocazione deve essere aggiunta utilizzando il metodo addInvocation.

Riepilogo

Metodi pubblici

abstract Invocation createInvocation(Invocation invocation)

Crea una chiamata in Test Storage utilizzando i dati nella chiamata fornita.

abstract Build createLocalBuild(Build localBuild)

Inserisci una build locale nel backend.

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

Crea un'unità di lavoro in Test Storage.

abstract ImmutableList<WorkUnit> createWorkUnits( workUnits)

Crea tutte le unità di lavoro in un elenco fornito in TestStorage.

abstract File fetchTestArtifact(String invocationId, String resourceId)

Recupera e restituisce il file dell'artefatto di test richiesto.

abstract void finalizeTestResults()

Attende il caricamento di tutti i risultati del test.

abstract Invocation getInvocation(String invocationId)

Restituisce una chiamata con l'ID chiamata fornito.

abstract BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

Restituisce un artefatto di test corrispondente all'ID risorsa e all'invocazione forniti.

abstract WorkUnit getWorkUnit(String workUnitId)

Restituisce un'unità di lavoro corrispondente all'ID fornito.

abstract TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

Cerca ed elenca tutti gli artefatti di test corrispondenti al tipo fornito.

abstract Invocation updateInvocation(Invocation invocation)

Aggiorna una chiamata in Test Storage utilizzando i dati della chiamata fornita.

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

Aggiorna l'artefatto fornito.

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

Aggiorna l'artefatto fornito e carica i contenuti forniti.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

Aggiorna un'unità di lavoro fornita in Test Storage.

abstract void uploadAssociations( associations, int poolSize)

Carica le associazioni tra log e test/unità di lavoro.

abstract void uploadResult(TestResult result)

Carica il risultato del test fornito in Test Storage.

Metodi pubblici

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

Crea una chiamata in Test Storage utilizzando i dati nella chiamata fornita.

Parametri
invocation Invocation: - descrive la chiamata da creare.

Ritorni
Invocation richiamo creato in Test Storage.

Lanci
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Inserisci una build locale nel backend.

Parametri
localBuild Build: descrizione della build locale

Ritorni
Build Build

Lanci
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Crea un'unità di lavoro in Test Storage.

Parametri
workUnit WorkUnit: descrive l'unità di lavoro da creare.

Ritorni
WorkUnit una nuova unità di lavoro.

Lanci
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Crea tutte le unità di lavoro in un elenco fornito in TestStorage.

Parametri
workUnits : - elenco delle unità di lavoro da creare.

Ritorni
ImmutableList<WorkUnit> Un elenco delle unità di lavoro create.

Lanci
IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

Recupera e restituisce il file dell'artefatto di test richiesto.

Parametri
invocationId String

resourceId String

Ritorni
File

finalizeTestResults

public abstract void finalizeTestResults ()

Attende il caricamento di tutti i risultati del test.

getInvocation

public abstract Invocation getInvocation (String invocationId)

Restituisce una chiamata con l'ID chiamata fornito.

Parametri
invocationId String: - id dell'invocazione da restituire.

Ritorni
Invocation

Lanci
- se la chiamata fornita non viene trovata o se si verifica un errore di comunicazione con il backend.

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Restituisce un artefatto di test corrispondente all'ID risorsa e all'invocazione forniti.

Parametri
invocationId String

resourceId String

Ritorni
BuildArtifactMetadata

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

Restituisce un'unità di lavoro corrispondente all'ID fornito.

Parametri
workUnitId String: - id dell'unità di lavoro.

Ritorni
WorkUnit

Lanci
- se l'unità di lavoro fornita non viene trovata o si verifica un errore di comunicazione con i servizi di backend.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Cerca ed elenca tutti gli artefatti di test corrispondenti al tipo fornito.

Parametri
invocationId String

artifactType String

Ritorni
TestArtifactListResponse

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

Aggiorna una chiamata in Test Storage utilizzando i dati nella chiamata fornita.

Parametri
invocation Invocation: - invocation with updated data.

Ritorni
Invocation un'invocazione aggiornata.

Lanci
IOException

updateTestArtifact

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

Aggiorna l'artefatto fornito. Questo metodo aggiorna solo l'associazione e non modifica i contenuti. Quando chiami questo metodo, fornisci l'ID invocazione originale, l'ID unità di lavoro e l'ID risultato del test come argomenti. Inserisci la nuova unità di lavoro e l'ID risultato del test nell'oggetto BuildArtifactMetadata. Quando l'ID unità di lavoro e/o il risultato del test non vengono utilizzati nell'associazione, devono essere impostati sulla stringa vuota ("").

Parametri
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

legacyId long

Ritorni
BuildArtifactMetadata

updateTestArtifact

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

Aggiorna l'artefatto fornito e carica i contenuti forniti. Quando carichi contenuti, non è possibile aggiornare i dati di associazione. Non modificare l'ID unità di lavoro e l'ID risultato del test già impostati nell'argomento BuildArtifactMetadata.

Parametri
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

Ritorni
BuildArtifactMetadata

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Aggiorna un'unità di lavoro fornita in Test Storage.

Parametri
workUnit WorkUnit: - work unit to update.

Ritorni
WorkUnit unità di lavoro aggiornata.

Lanci
IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

Carica le associazioni tra log e test/unità di lavoro. Le associazioni consentono ad Android Test Storage di tenere traccia del test che ha prodotto un log.

Parametri
associations : un elenco di file di log e delle relative associazioni.

poolSize int: le dimensioni del pool di worker utilizzato per il caricamento parallelo. 0 per nessun caricamento parallelo.

Lanci
IOException

uploadResult

public abstract void uploadResult (TestResult result)

Carica il risultato del test fornito in Test Storage. Il risultato del test deve far parte di una chiamata creata in precedenza.

Parametri
result TestResult: - risultato da caricare.

Lanci
IOException