IFileDownloader
public interface IFileDownloader
com.android.tradefed.build.IFileDownloader |
Interfejs do pobierania zdalnego pliku.
Streszczenie
Metody publiczne | |
---|---|
default void | acquireDownloadPermit () Jeśli obsługiwany jest limit współbieżności, uzyskaj pozwolenie na pobieranie. |
default void | downloadFile (String remoteFilePath, File destFile, long startOffset, long size) Alternatywna forma |
abstract void | downloadFile (String relativeRemotePath, File destFile) Alternatywna forma |
abstract File | downloadFile (String remoteFilePath) Pobiera plik zdalny do pliku tymczasowego na dysku lokalnym. |
default void | downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) Pobierz pliki pasujące do podanych filtrów w zdalnym pliku ZIP. |
default boolean | isFresh (File localFile, String remoteFilePath) Sprawdź aktualność pliku lokalnego. |
default void | releaseDownloadPermit () Jeśli obsługiwany jest limit współbieżności, zwolnij zezwolenie na pobieranie. |
Metody publiczne
nabyćPozwolenie na pobranie
public void acquireDownloadPermit ()
Jeśli obsługiwany jest limit współbieżności, uzyskaj pozwolenie na pobieranie.
pobieranie pliku
public void downloadFile (String remoteFilePath, File destFile, long startOffset, long size)
Alternatywna forma downloadFile(String, File)
, która umożliwia wywołującemu pobranie sekcji pliku i zapisanie w określonym pliku docelowym.
Parametry | |
---|---|
remoteFilePath | String : zdalna ścieżka do pliku do pobrania, względem katalogu głównego specyficznego dla implementacji. |
destFile | File : plik, w którym należy umieścić pobraną zawartość. Nie powinno istnieć. |
startOffset | long : przesunięcie początkowe w pliku zdalnym. |
size | long : liczba bajtów do pobrania ze zdalnego pliku. Ustaw wartość ujemną, aby pobrać cały plik. |
Rzuca | |
---|---|
BuildRetrievalError | jeśli nie można było pobrać pliku |
pobieranie pliku
public abstract void downloadFile (String relativeRemotePath, File destFile)
Alternatywna forma downloadFile(String)
, która pozwala wywołującemu określić plik docelowy, w którym powinna zostać umieszczona zdalna zawartość.
Parametry | |
---|---|
relativeRemotePath | String : zdalna ścieżka do pliku do pobrania, względem katalogu głównego specyficznego dla implementacji. |
destFile | File : plik, w którym należy umieścić pobraną zawartość. Nie powinno istnieć. |
Rzuca | |
---|---|
BuildRetrievalError | jeśli nie można było pobrać pliku |
pobieranie pliku
public abstract File downloadFile (String remoteFilePath)
Pobiera plik zdalny do pliku tymczasowego na dysku lokalnym.
Parametry | |
---|---|
remoteFilePath | String : zdalna ścieżka do pliku do pobrania, w odniesieniu do katalogu głównego specyficznego dla implementacji. |
Zwroty | |
---|---|
File | tymczasowy pobrany lokalnie ERROR(/File) . |
Rzuca | |
---|---|
BuildRetrievalError | jeśli nie można było pobrać pliku |
pobierz ZippedFiles
public void downloadZippedFiles (File destDir, String remoteFilePath,includeFilters, excludeFilters)
Pobierz pliki pasujące do podanych filtrów w zdalnym pliku ZIP.
Plik znajdujący się w zdalnym pliku ZIP jest pobierany tylko do ścieżki odpowiadającej dowolnemu filtrowi włączającemu, ale nie filtrowi wykluczającemu.
Parametry | |
---|---|
destDir | File : plik, w którym należy umieścić pobraną zawartość. |
remoteFilePath | String : zdalna ścieżka do pliku do pobrania, w odniesieniu do katalogu głównego specyficznego dla implementacji. |
includeFilters | |
excludeFilters |
Rzuca | |
---|---|
BuildRetrievalError | jeśli nie można było pobrać plików. |
| Wyjątek IO |
jestświeży
public boolean isFresh (File localFile, String remoteFilePath)
Sprawdź aktualność pliku lokalnego. Jeśli plik lokalny jest taki sam jak plik zdalny, oznacza to, że jest świeży. Jeśli nie, plik lokalny jest nieaktualny. Jest to używane głównie do pamięci podręcznej. Domyślna implementacja zawsze zwróci wartość true, więc jeśli plik jest niezmienny, nigdy nie będzie musiał sprawdzać aktualności.
Parametry | |
---|---|
localFile | File : plik lokalny. |
remoteFilePath | String : zdalna ścieżka pliku. |
Zwroty | |
---|---|
boolean | Prawda, jeśli plik lokalny jest świeży, w przeciwnym razie fałsz. |
Rzuca | |
---|---|
| com.android.tradefed.build.BuildRetrievalError |
BuildRetrievalError |
zwolnijPozwolenie na pobranie
public void releaseDownloadPermit ()
Jeśli obsługiwany jest limit współbieżności, zwolnij zezwolenie na pobieranie.