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 downloadFile(String,File), która umożliwia wywołującemu pobranie części pliku i zapisanie jej w określonym pliku docelowym.

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.

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.