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

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ść.

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 : lista filtrów umożliwiających pobranie pasujących plików.

excludeFilters : lista filtrów pozwalających pominąć pobieranie pasujących plików.

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.