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, 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 ()

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