IFileDownloader
public interface IFileDownloader
com.android.tradefed.build.IFileDownloader |
Интерфейс для загрузки удаленного файла.
Краткое содержание
Публичные методы | |
---|---|
default void | acquireDownloadPermit () Если поддерживается ограничение параллелизма, получите разрешение на загрузку. |
default void | downloadFile (String remoteFilePath, File destFile, long startOffset, long size) Альтернативная форма |
abstract void | downloadFile (String relativeRemotePath, File destFile) Альтернативная форма |
abstract File | downloadFile (String remoteFilePath) Загружает удаленный файл во временный файл на локальном диске. |
default void | downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) Загрузите файлы, соответствующие заданным фильтрам, в удаленный zip-файл. |
default boolean | isFresh (File localFile, String remoteFilePath) Проверьте свежесть локального файла. |
default void | releaseDownloadPermit () Если поддерживается ограничение параллелизма, отпустите разрешение на загрузку. |
Публичные методы
приобрестиЗагрузитьРазрешение
public void acquireDownloadPermit ()
Если поддерживается ограничение параллелизма, получите разрешение на загрузку.
скачатьФайл
public void downloadFile (String remoteFilePath, File destFile, long startOffset, long size)
Альтернативная форма downloadFile(String, File)
, которая позволяет вызывающему объекту загрузить часть файла и сохранить его в определенном целевом файле.
Параметры | |
---|---|
remoteFilePath | String : удаленный путь к файлу для загрузки относительно корня, зависящего от реализации. |
destFile | File : файл, в который будет помещено загруженное содержимое. Не должно существовать. |
startOffset | long : начальное смещение в удаленном файле. |
size | long : количество байтов для загрузки из удаленного файла. Установите отрицательное значение, чтобы загрузить весь файл. |
Броски | |
---|---|
BuildRetrievalError | если файл не удалось загрузить |
скачатьФайл
public abstract void downloadFile (String relativeRemotePath, File destFile)
Альтернативная форма downloadFile(String)
, которая позволяет вызывающей стороне указать файл назначения, в который должно быть помещено удаленное содержимое.
Параметры | |
---|---|
relativeRemotePath | String : удаленный путь к файлу для загрузки относительно корня, специфичного для реализации. |
destFile | File : файл, в который будет помещено загруженное содержимое. Не должно существовать. |
Броски | |
---|---|
BuildRetrievalError | если файл не удалось загрузить |
скачатьФайл
public abstract File downloadFile (String remoteFilePath)
Загружает удаленный файл во временный файл на локальном диске.
Параметры | |
---|---|
remoteFilePath | String : удаленный путь к файлу для загрузки относительно корня конкретной реализации. |
Возврат | |
---|---|
File | временная локальная загруженная ERROR(/File) . |
Броски | |
---|---|
BuildRetrievalError | если файл не удалось загрузить |
скачатьZippedFiles
public void downloadZippedFiles (File destDir, String remoteFilePath,includeFilters, excludeFilters)
Загрузите файлы, соответствующие заданным фильтрам, в удаленный zip-файл.
Файл внутри удаленного zip-файла загружается только по тому пути, который соответствует любому из фильтров включения, но не фильтрам исключения.
Параметры | |
---|---|
destDir | File : файл, в который будет помещено загруженное содержимое. |
remoteFilePath | String : удаленный путь к файлу для загрузки относительно корня конкретной реализации. |
includeFilters | |
excludeFilters |
Броски | |
---|---|
BuildRetrievalError | если файлы не удалось загрузить. |
| Исключение IO |
isFresh
public boolean isFresh (File localFile, String remoteFilePath)
Проверьте свежесть локального файла. Если локальный файл совпадает с удаленным файлом, значит, он свежий. В противном случае локальный файл устарел. В основном это используется для кэша. Реализация по умолчанию всегда будет возвращать true, поэтому, если файл является неизменяемым, ему никогда не потребуется проверять свежесть.
Параметры | |
---|---|
localFile | File : локальный файл. |
remoteFilePath | String : путь к удаленному файлу. |
Возврат | |
---|---|
boolean | True, если локальный файл свежий, в противном случае — false. |
Броски | |
---|---|
| com.android.tradefed.build.BuildRetrivalError |
BuildRetrievalError |
выпускЗагрузитьРазрешить
public void releaseDownloadPermit ()
Если поддерживается ограничение параллелизма, отпустите разрешение на загрузку.