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( 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 sind.

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( 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.
Returns
Invocation Aufruf, der in Test Storage erstellt wurde.
Ausgabe
IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Lokalen Build in das Backend einfügen

Parameter
localBuild Build: Beschreibung des lokalen Builds
Returns
Build Build
Ausgabe
IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Erstellt eine Arbeitseinheit im Testspeicher.

Parameter
workUnit WorkUnit: Beschreibt die zu erstellende Arbeitseinheit.
Returns
WorkUnit eine neue Arbeitseinheit.
Ausgabe
IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Erstellt alle Arbeitseinheiten in einer bereitgestellten Liste in TestStorage.

Parameter
workUnits : Liste der zu erstellenden Arbeitseinheiten.
Returns
ImmutableList<WorkUnit> Eine Liste der erstellten Arbeitsbereiche.
Ausgabe
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

Returns
File

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: Die ID des zurückzugebenden Aufrufs.
Returns
Invocation

Ausgabe
– 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

Returns
BuildArtifactMetadata

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

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

Parameter
workUnitId String: ID der Arbeitseinheit.
Returns
WorkUnit

Ausgabe
– wenn die bereitgestellte Arbeitsaufgabe 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

Returns
TestArtifactListResponse

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.
Returns
Invocation einen aktualisierten Aufruf.
Ausgabe
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 Arbeitsaufgabe und die Test-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

Returns
BuildArtifactMetadata

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

Returns
BuildArtifactMetadata

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Aktualisiert eine bereitgestellte Arbeitsaufgabe im Test Storage.

Parameter
workUnit WorkUnit: Die zu aktualisierende Arbeitseinheit.
Returns
WorkUnit aktualisierte Arbeitseinheit.
Ausgabe
IOException

uploadAssociations

public abstract void uploadAssociations ( 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 : 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.
Ausgabe
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.
Ausgabe
IOException