IFileDownloader
public
interface
IFileDownloader
| com.android.tradefed.build.IFileDownloader |
Interfejs do pobierania pliku zdalnego.
Podsumowanie
Metody publiczne | |
|---|---|
default
void
|
acquireDownloadPermit()
Jeśli limit współbieżności jest obsługiwany, pobierz zezwolenie na pobieranie. |
default
void
|
downloadFile(String remoteFilePath, File destFile, long startOffset, long size)
Alternatywna forma |
abstract
void
|
downloadFile(String relativeRemotePath, File destFile)
Alternatywna forma funkcji |
abstract
File
|
downloadFile(String remoteFilePath)
Pobiera plik zdalny do pliku tymczasowego na dysku lokalnym. |
default
void
|
downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> 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 limit współbieżności jest obsługiwany, zwolnij pozwolenie na pobieranie. |
Metody publiczne
acquireDownloadPermit
public void acquireDownloadPermit ()
Jeśli limit współbieżności jest obsługiwany, pobierz zezwolenie na pobieranie.
downloadFile
public void downloadFile (String remoteFilePath,
File destFile,
long startOffset,
long size)Alternatywna forma downloadFile(String,File), która umożliwia wywołującemu pobranie części pliku i zapisanie jej w określonym pliku docelowym.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka zdalna do pliku do pobrania, względna w stosunku do korzenia specyficznego dla implementacji. |
destFile |
File: plik, w którym mają zostać umieszczone pobrane treści. Nie powinno istnieć. |
startOffset |
long: przesunięcie początkowe w pliku zdalnym. |
size |
long: liczba bajtów do pobrania z pliku zdalnego. Ustaw wartość ujemną, aby pobrać cały plik. |
| Zgłasza | |
|---|---|
BuildRetrievalError |
jeśli nie udało się pobrać pliku. |
downloadFile
public abstract void downloadFile (String relativeRemotePath,
File destFile)Alternatywna forma funkcji downloadFile(String), która umożliwia wywołującemu określenie pliku docelowego, w którym mają się znaleźć zdalne treści.
| Parametry | |
|---|---|
relativeRemotePath |
String: ścieżka zdalna do pliku do pobrania, względna w stosunku do korzenia specyficznego dla implementacji. |
destFile |
File: plik, w którym mają zostać umieszczone pobrane treści. Nie powinno istnieć. |
| Zgłasza | |
|---|---|
BuildRetrievalError |
jeśli nie udało się pobrać pliku. |
downloadFile
public abstract File downloadFile (String remoteFilePath)
Pobiera plik zdalny do pliku tymczasowego na dysku lokalnym.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka zdalna do pliku do pobrania, względna w stosunku do katalogu głównego specyficznego dla implementacji. |
| Zwraca | |
|---|---|
File |
tymczasowy lokalny plik pobrany File. |
| Zgłasza | |
|---|---|
BuildRetrievalError |
jeśli nie udało się pobrać pliku. |
downloadZippedFiles
public void downloadZippedFiles (File destDir,
String remoteFilePath,
List<String> includeFilters,
List<String> excludeFilters)Pobierz pliki pasujące do podanych filtrów w zdalnym pliku ZIP.
Plik w zdalnym archiwum ZIP jest pobierany tylko wtedy, gdy jego ścieżka pasuje do dowolnego filtra uwzględniania, ale nie do filtra wykluczania.
| Parametry | |
|---|---|
destDir |
File: plik, w którym mają zostać umieszczone pobrane treści. |
remoteFilePath |
String: ścieżka zdalna do pliku do pobrania, względna w stosunku do katalogu głównego specyficznego dla implementacji. |
includeFilters |
List: lista filtrów do pobierania pasujących plików. |
excludeFilters |
List: lista filtrów, które pozwalają pominąć pobieranie pasujących plików. |
| Zgłasza | |
|---|---|
BuildRetrievalError |
jeśli nie udało się pobrać plików. |
|
java.io.IOException |
IOException |
|
isFresh
public boolean isFresh (File localFile,
String remoteFilePath)Sprawdź aktualność pliku lokalnego. Jeśli plik lokalny jest taki sam jak plik zdalny, jest aktualny. W przeciwnym razie plik lokalny jest nieaktualny. Jest to używane głównie w przypadku pamięci podręcznej. Domyślna implementacja zawsze zwraca wartość „true”, więc jeśli plik jest niezmienny, nie trzeba sprawdzać jego świeżości.
| Parametry | |
|---|---|
localFile |
File: plik lokalny. |
remoteFilePath |
String: ścieżka do pliku zdalnego. |
| Zwraca | |
|---|---|
boolean |
Wartość true, jeśli plik lokalny jest aktualny. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.build.BuildRetrievalError |
BuildRetrievalError |
|
releaseDownloadPermit
public void releaseDownloadPermit ()
Jeśli limit współbieżności jest obsługiwany, zwolnij pozwolenie na pobieranie.