IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Bekannte indirekte Unterklassen FileDownloadCacheWrapper , GCSFileDownloader FileDownloadCacheWrapper Eine Wrapper-Klasse, die FileDownloadCache Einrichtungen bereitstellt, während sie die IFileDownloader Schnittstelle implementiert. GCSFileDownloader Datei-Downloader zum Herunterladen von Dateien aus Google Cloud Storage (GCS).

---

Schnittstelle zum Herunterladen einer Remote-Datei.

Zusammenfassung

Öffentliche Methoden
default void	acquireDownloadPermit () Wenn die Gleichzeitigkeitsbegrenzung unterstützt wird, besorgen Sie sich eine Download-Genehmigung.
default void	downloadFile (String remoteFilePath, File destFile, long startOffset, long size) Alternative Form von downloadFile(String, File) , die es dem Aufrufer ermöglicht, einen Abschnitt der Datei herunterzuladen und in einer bestimmten Zieldatei zu speichern.
abstract void	downloadFile (String relativeRemotePath, File destFile) Alternative Form von downloadFile(String) , mit der der Aufrufer die Zieldatei angeben kann, in der die entfernten Inhalte abgelegt werden sollen.
abstract File	downloadFile (String remoteFilePath) Lädt eine Remote-Datei in eine temporäre Datei auf der lokalen Festplatte herunter.
default void	downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) Laden Sie die Dateien herunter, die den angegebenen Filtern in einer Remote-ZIP-Datei entsprechen.
default boolean	isFresh (File localFile, String remoteFilePath) Überprüfen Sie die Frische der lokalen Datei.
default void	releaseDownloadPermit () Wenn die Gleichzeitigkeitsbegrenzung unterstützt wird, geben Sie eine Download-Genehmigung frei.

Öffentliche Methoden

erwerbenDownloadPermit

public void acquireDownloadPermit ()

Wenn die Gleichzeitigkeitsbegrenzung unterstützt wird, besorgen Sie sich eine Download-Genehmigung.

Download-Datei

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

Alternative Form von downloadFile(String, File) , die es dem Aufrufer ermöglicht, einen Abschnitt der Datei herunterzuladen und in einer bestimmten Zieldatei zu speichern.

Parameter
remoteFilePath	String : Der Remote-Pfad zu der herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.
destFile	File : Die Datei, in der die heruntergeladenen Inhalte platziert werden sollen. Sollte nicht vorhanden sein.
startOffset	long : der Start-Offset in der Remote-Datei.
size	long : Die Anzahl der Bytes, die von der Remote-Datei heruntergeladen werden sollen. Legen Sie einen negativen Wert fest, um die gesamte Datei herunterzuladen.

Wirft
BuildRetrievalError	wenn die Datei nicht heruntergeladen werden konnte

Download-Datei

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

Parameter
relativeRemotePath	String : Der Remote-Pfad zu der herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.
destFile	File : Die Datei, in der die heruntergeladenen Inhalte platziert werden sollen. Sollte nicht vorhanden sein.

Wirft
BuildRetrievalError	wenn die Datei nicht heruntergeladen werden konnte

Download-Datei

public abstract File downloadFile (String remoteFilePath)

Lädt eine Remote-Datei in eine temporäre Datei auf der lokalen Festplatte herunter.

Parameter
remoteFilePath	String : Der Remote-Pfad zu der herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.

Kehrt zurück
File	die temporär lokal heruntergeladene ERROR(/File) .

Wirft
BuildRetrievalError	wenn die Datei nicht heruntergeladen werden konnte

downloadZippedFiles

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

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

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

Parameter
destDir	File : Die Datei, in der die heruntergeladenen Inhalte platziert werden sollen.
remoteFilePath	String : Der Remote-Pfad zu der herunterzuladenden Datei, relativ zu einem implementierungsspezifischen Stammverzeichnis.
includeFilters	: eine Liste von Filtern zum Herunterladen passender Dateien.
excludeFilters	: eine Liste von Filtern, um das Herunterladen passender Dateien zu überspringen.

Wirft
BuildRetrievalError	wenn Dateien nicht heruntergeladen werden konnten.
	IOException

istFrisch

public boolean isFresh (File localFile, 
                String remoteFilePath)

Überprüfen Sie die Frische der lokalen Datei. Wenn die lokale Datei mit der Remote-Datei identisch ist, ist sie frisch. Wenn nicht, ist die lokale Datei veraltet. Dies wird hauptsächlich für den Cache verwendet. Die Standardimplementierung gibt immer true zurück, wenn die Datei also unveränderlich ist, muss sie nie auf Aktualität überprüft werden.

Parameter
localFile	File : Lokale Datei.
remoteFilePath	String : Remote-Dateipfad.

Kehrt zurück
boolean	True, wenn die lokale Datei neu ist, andernfalls false.

Wirft
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

Wenn die Gleichzeitigkeitsbegrenzung unterstützt wird, geben Sie eine Download-Genehmigung frei.