ITestStorageClient

public interface ITestStorageClient

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

Schnittstelle für die Kommunikation mit dem Android Test Storage-Backend. Die Schnittstelle enthält Methoden zum Erstellen und Aktualisieren von Aufrufen und Arbeitseinheiten sowie zum Hochladen von Testergebnissen. Damit Arbeitsbereiche oder Testergebnisse erstellt oder aktualisiert werden können, müssen sie zu einem Aufruf gehören, der entweder von diesem Client erstellt wurde oder der mit der Methode „addInvocation“ hinzugefügt wurde.

Zusammenfassung

Öffentliche Methoden

abstract Invocation createInvocation(Invocation invocation)

Erstellt einen Aufruf im Test Storage mit den Daten im bereitgestellten Aufruf.

abstract Build createLocalBuild(Build localBuild)

Lokalen Build in das Backend einfügen

abstract WorkUnit createWorkUnit(WorkUnit workUnit)

Erstellt eine Arbeitseinheit im Testspeicher.

abstract ImmutableList<WorkUnit> createWorkUnits(List<WorkUnit> workUnits)

Erstellt alle Arbeitseinheiten in einer bereitgestellten Liste in TestStorage.

abstract File fetchTestArtifact(String invocationId, String resourceId)

Ruft die angeforderte Testartefaktdatei ab und gibt sie zurück.

abstract void finalizeTestResults()

Wartet, bis alle Testergebnisse hochgeladen wurden.

abstract Invocation getInvocation(String invocationId)

Gibt einen Aufruf mit der angegebenen Aufruf-ID zurück.

abstract BuildArtifactMetadata getTestArtifact(String invocationId, String resourceId)

Gibt ein Testartefakt zurück, das der angegebenen Aufruf- und Ressourcen-ID entspricht.

abstract WorkUnit getWorkUnit(String workUnitId)

Gibt eine Workunit zurück, die der angegebenen ID entspricht.

abstract TestArtifactListResponse listTestArtifact(String invocationId, String artifactType)

Sucht nach allen Testartefakten, die dem angegebenen Typ entsprechen, und listet sie auf.

abstract Invocation updateInvocation(Invocation invocation)

Aktualisiert einen Aufruf im Testspeicher mit den Daten im bereitgestellten Aufruf.

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

Aktualisiert das angegebene Artefakt.

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

Aktualisiert das bereitgestellte Artefakt und lädt die bereitgestellten Inhalte hoch.

abstract WorkUnit updateWorkUnit(WorkUnit workUnit)

Aktualisiert eine bereitgestellte Arbeitsaufgabe im Test Storage.

abstract void uploadAssociations(List<LogAssociation> associations, int poolSize)

Lädt Verknüpfungen zwischen Logs und Tests/Arbeitseinheiten hoch.

abstract void uploadResult(TestResult result)

Laden Sie das bereitgestellte Testergebnis in Test Storage hoch.

Öffentliche Methoden

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

Erstellt einen Aufruf im Test Storage mit den Daten im bereitgestellten Aufruf.

Parameter
invocation Invocation: Beschreibt den Aufruf, der erstellt werden soll.
Gibt Folgendes zurück:
Invocation Aufruf, der im Testspeicher erstellt wurde.
Löst aus
java.io.IOException
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Lokalen Build in das Backend einfügen

Parameter
localBuild Build: Beschreibung des lokalen Builds
Gibt Folgendes zurück:
Build einem Build
Löst aus
java.io.IOException
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Erstellt eine Arbeitseinheit im Testspeicher.

Parameter
workUnit WorkUnit: Beschreibt die zu erstellende Arbeitseinheit.
Gibt Folgendes zurück:
WorkUnit eine neue Arbeitseinheit.
Löst aus
java.io.IOException
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits (List<WorkUnit> workUnits)

Erstellt alle Arbeitseinheiten in einer bereitgestellten Liste in TestStorage.

Parameter
workUnits List: Liste der zu erstellenden Arbeitseinheiten.
Gibt Folgendes zurück:
ImmutableList<WorkUnit> Eine Liste der erstellten Arbeitsbereiche.
Löst aus
java.io.IOException
IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

Ruft die angeforderte Testartefaktdatei ab und gibt sie zurück.

Parameter
invocationId String

resourceId String

Gibt Folgendes zurück:
File

Löst aus
IOException

finalizeTestResults

public abstract void finalizeTestResults ()

Wartet, bis alle Testergebnisse hochgeladen wurden.

getInvocation

public abstract Invocation getInvocation (String invocationId)

Gibt einen Aufruf mit der angegebenen Aufruf-ID zurück.

Parameter
invocationId String: ID des zurückzugebenden Aufrufs.
Gibt Folgendes zurück:
Invocation

Löst aus
IOException – wenn der angegebene Aufruf nicht gefunden wird oder bei der Kommunikation mit dem Backend ein Fehler auftritt.

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Gibt ein Testartefakt zurück, das der angegebenen Aufruf- und Ressourcen-ID entspricht.

Parameter
invocationId String

resourceId String

Gibt Folgendes zurück:
BuildArtifactMetadata

Löst aus
IOException

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

Gibt eine Workunit zurück, die der angegebenen ID entspricht.

Parameter
workUnitId String: ID der Arbeitsaufgabe.
Gibt Folgendes zurück:
WorkUnit

Löst aus
IOException – wenn die bereitgestellte Arbeitseinheit nicht gefunden wird oder bei der Kommunikation mit Backend-Diensten ein Fehler auftritt.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Sucht nach allen Testartefakten, die dem angegebenen Typ entsprechen, und listet sie auf.

Parameter
invocationId String

artifactType String

Gibt Folgendes zurück:
TestArtifactListResponse

Löst aus
IOException

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

Aktualisiert einen Aufruf im Testspeicher mit den Daten im bereitgestellten Aufruf.

Parameter
invocation Invocation: Aufruf mit aktualisierten Daten.
Gibt Folgendes zurück:
Invocation einen aktualisierten Aufruf.
Löst aus
java.io.IOException
IOException

updateTestArtifact

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

Aktualisiert das angegebene Artefakt. Mit dieser Methode wird nur die Verknüpfung aktualisiert. Die Inhalte werden nicht geändert. Geben Sie beim Aufrufen dieser Methode die ursprüngliche Aufruf-ID, die Arbeitsauftrags-ID und die Testergebnis-ID als Argumente an. Fügen Sie die neue Arbeits- und die Testergebnis-ID in das BuildArtifactMetadata-Objekt ein. Wenn die Arbeitsauftrags-ID und/oder das Testergebnis nicht in der Zuordnung verwendet werden, sollten sie auf einen leeren String ("") gesetzt werden.

Parameter
invocationId String

workUnitId String

testResultId String

artifact BuildArtifactMetadata

legacyId long

Gibt Folgendes zurück:
BuildArtifactMetadata

Löst aus
IOException

updateTestArtifact

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

Aktualisiert das bereitgestellte Artefakt und lädt die bereitgestellten Inhalte hoch. Beim Hochladen von Inhalten können keine Zuordnungsdaten aktualisiert werden. Ändern Sie nicht die Arbeitsauftrags-ID und die Testergebnis-ID, die bereits im Argument „BuildArtifactMetadata“ festgelegt sind.

Parameter
artifact BuildArtifactMetadata

legacyId long

content AbstractInputStreamContent

Gibt Folgendes zurück:
BuildArtifactMetadata

Löst aus
IOException

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Aktualisiert eine bereitgestellte Arbeitsaufgabe im Test Storage.

Parameter
workUnit WorkUnit: Die zu aktualisierende Arbeitseinheit.
Gibt Folgendes zurück:
WorkUnit aktualisierte Arbeitseinheit.
Löst aus
java.io.IOException
IOException

uploadAssociations

public abstract void uploadAssociations (List<LogAssociation> associations, 
                int poolSize)

Lädt Verknüpfungen zwischen Logs und Tests/Arbeitseinheiten hoch. Mit Zuordnungen kann Android Test Storage nachverfolgen, welcher Test ein Log erzeugt hat.

Parameter
associations List: Eine Liste der Logdateien und ihrer Zuordnungen.
poolSize int: Die Größe des Worker-Pools, der für den parallelen Upload verwendet wird. 0 für keinen parallelen Upload.
Löst aus
java.io.IOException
IOException

uploadResult

public abstract void uploadResult (TestResult result)

Laden Sie das bereitgestellte Testergebnis in Test Storage hoch. Das Testergebnis muss Teil eines zuvor erstellten Aufrufs sein.

Parameter
result TestResult: Das hochzuladende Ergebnis.
Löst aus
java.io.IOException