IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Интерфейс для загрузки удаленного файла.

Краткое содержание

Общедоступные методы

default void acquireDownloadPermit ()

Если поддерживается ограничение на количество одновременных загрузок, получите разрешение на скачивание.

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

Альтернативная форма метода downloadFile(String,File) , позволяющая вызывающей стороне загрузить часть файла и сохранить её в указанный файл назначения.

abstract void downloadFile (String relativeRemotePath, File destFile)

Альтернативная форма метода downloadFile(String) , позволяющая вызывающей стороне указать целевой файл, в который должны быть помещены удаленные данные.

abstract File downloadFile (String remoteFilePath)

Загружает удаленный файл во временный файл на локальном диске.

default void downloadZippedFiles (File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)

Загрузите файлы, соответствующие заданным фильтрам, в удаленный ZIP-архив.

default boolean isFresh (File localFile, String remoteFilePath)

Проверьте актуальность локального файла.

default void releaseDownloadPermit ()

Если поддерживается ограничение на количество одновременных загрузок, освободите разрешение на скачивание.

Общедоступные методы

acquireDownloadPermit 

public void acquireDownloadPermit ()

Если поддерживается ограничение на количество одновременных загрузок, получите разрешение на скачивание.

downloadFile 

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

Альтернативная форма метода downloadFile(String,File) , позволяющая вызывающей стороне загрузить часть файла и сохранить её в указанный файл назначения.

Параметры
remoteFilePath String : удаленный путь к файлу для загрузки, относительно корневого каталога, специфичного для данной реализации.

destFile File : файл, в который следует поместить загруженное содержимое. Должен не существовать.

startOffset long : начальное смещение в удаленном файле.

size long : количество байтов для загрузки из удалённого файла. Установите отрицательное значение, чтобы загрузить весь файл.

Броски
BuildRetrievalError если файл не удалось загрузить

downloadFile 

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Альтернативная форма метода downloadFile(String) , позволяющая вызывающей стороне указать целевой файл, в который должны быть помещены удаленные данные.

Параметры
relativeRemotePath String : удаленный путь к файлу для загрузки, относительно корневого каталога, специфичного для данной реализации.

destFile File : файл, в который следует поместить загруженное содержимое. Должен не существовать.

Броски
BuildRetrievalError если файл не удалось загрузить

downloadFile 

public abstract File downloadFile (String remoteFilePath)

Загружает удаленный файл во временный файл на локальном диске.

Параметры
remoteFilePath String : удаленный путь к файлу для загрузки, относительно корневого каталога, специфичного для данной реализации.

Возвраты
File Временно загруженный локальный File .

Броски
BuildRetrievalError если файл не удалось загрузить

скачать ZippedFiles 

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

Загрузите файлы, соответствующие заданным фильтрам, в удаленный ZIP-архив.

Файл внутри удалённого ZIP-архива загружается только в том случае, если его путь соответствует любому из фильтров включения, но не фильтрам исключения.

Параметры
destDir File : файл, в который будут помещены загруженные файлы.

remoteFilePath String : удаленный путь к файлу для загрузки, относительно корневого каталога, специфичного для данной реализации.

includeFilters List : перечень фильтров для загрузки соответствующих файлов.

excludeFilters List : перечень фильтров, позволяющих пропустить загрузку соответствующих файлов.

Броски
BuildRetrievalError если файлы не удалось загрузить.
java.io.IOException
IOException

isFresh 

public boolean isFresh (File localFile, 
                String remoteFilePath)

Проверка актуальности локального файла. Если локальный файл совпадает с удалённым, значит, он актуален. В противном случае локальный файл устарел. Это в основном используется для кэширования. Реализация по умолчанию всегда возвращает true, поэтому, если файл неизменяем, проверка его актуальности никогда не потребуется.

Параметры
localFile File : локальный файл.

remoteFilePath String : путь к удаленному файлу.

Возвраты
boolean Возвращает true, если локальный файл новый, в противном случае — false.

Броски
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit 

public void releaseDownloadPermit ()

Если поддерживается ограничение на количество одновременных загрузок, освободите разрешение на скачивание.