IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader


Benutzeroberfläche zum Herunterladen einer Remote-Datei.

Zusammenfassung

Öffentliche Methoden

default void acquireDownloadPermit()

Wenn das Limit für die Parallelität unterstützt wird, beantragen Sie eine Downloadgenehmigung.

default void downloadFile(String remoteFilePath, File destFile, long startOffset, long size)

Alternative Form von downloadFile(String, File), mit der der Aufrufer einen Abschnitt der Datei herunterladen und in einer bestimmten Zieldatei speichern kann.

abstract void downloadFile(String relativeRemotePath, File destFile)

Alternative Form von downloadFile(String), mit der der Aufrufer die Zieldatei angeben kann, in die die Remote-Inhalte abgelegt werden sollen.

abstract File downloadFile(String remoteFilePath)

Eine Remotedatei wird in eine temporäre Datei auf dem lokalen Laufwerk heruntergeladen.

default void downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters)

Laden Sie die Dateien, die den angegebenen Filtern entsprechen, in einer Remote-ZIP-Datei herunter.

default boolean isFresh(File localFile, String remoteFilePath)

Prüfen Sie die Aktualität der lokalen Datei.

default void releaseDownloadPermit()

Wenn das Limit für die Parallelität unterstützt wird, gib eine Downloadberechtigung frei.

Öffentliche Methoden

acquireDownloadPermit

public void acquireDownloadPermit ()

Wenn das Limit für die Parallelität unterstützt wird, beantragen Sie eine Downloadgenehmigung.

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

Alternative Form von downloadFile(String, File), mit der der Aufrufer einen Abschnitt der Datei herunterladen und in einer bestimmten Zieldatei speichern kann.

Parameter
remoteFilePath String: Der Remotepfad zur herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.

destFile File: die Datei, in der die heruntergeladenen Inhalte abgelegt werden sollen. Sollte nicht vorhanden sein.

startOffset long: der Startoffset in der Remotedatei.

size long: die Anzahl der Byte, die aus der Remote-Datei heruntergeladen werden sollen. Legen Sie einen negativen Wert fest, um die gesamte Datei herunterzuladen.

Ausgabe
BuildRetrievalError if file could not be downloaded

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Alternative Form von downloadFile(String), mit der der Aufrufer die Zieldatei angeben kann, in die die Remote-Inhalte abgelegt werden sollen.

Parameter
relativeRemotePath String: Der Remotepfad zur herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.

destFile File: die Datei, in der die heruntergeladenen Inhalte abgelegt werden sollen. Sollte nicht vorhanden sein.

Ausgabe
BuildRetrievalError if file could not be downloaded

downloadFile

public abstract File downloadFile (String remoteFilePath)

Eine Remotedatei wird in eine temporäre Datei auf dem lokalen Laufwerk heruntergeladen.

Parameter
remoteFilePath String: Der Remotepfad zur herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.

Returns
File die temporär lokal heruntergeladene ERROR(/File).

Ausgabe
BuildRetrievalError if file could not be downloaded

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                 includeFilters, 
                 excludeFilters)

Laden Sie die Dateien, die den angegebenen Filtern entsprechen, in einer Remote-ZIP-Datei herunter.

Eine Datei in der Remote-ZIP-Datei wird nur heruntergeladen, wenn ihr Pfad mit einem der Einschlussfilter, aber nicht mit einem der Ausschlussfilter übereinstimmt.

Parameter
destDir File: die Datei, in der die heruntergeladenen Inhalte abgelegt werden sollen.

remoteFilePath String: Der Remotepfad zur herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.

includeFilters : Liste der Filter zum Herunterladen übereinstimmender Dateien.

excludeFilters : Liste der Filter, mit denen der Download übereinstimmender Dateien übersprungen wird.

Ausgabe
BuildRetrievalError wenn Dateien nicht heruntergeladen werden konnten.
IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Prüfen Sie die Aktualität der lokalen Datei. Wenn die lokale Datei mit der Remotedatei identisch ist, ist sie aktuell. Andernfalls ist die lokale Datei veraltet. Dieser Wert wird hauptsächlich für den Cache verwendet. Die Standardimplementierung gibt immer „wahr“ zurück. Wenn die Datei also unveränderlich ist, muss die Aktualität nie überprüft werden.

Parameter
localFile File: lokale Datei.

remoteFilePath String: Pfad zur Remotedatei.

Returns
boolean „True“, wenn die lokale Datei aktuell ist, andernfalls „False“.

Ausgabe
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

Wenn das Limit für die Parallelität unterstützt wird, gib eine Downloadberechtigung frei.