文件下载器

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如果文件无法下载

下载压缩文件

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

下载远程 zip 文件中与给定过滤器匹配的文件。

远程 zip 文件内的文件仅下载到其与任何包含过滤器匹配但不与排除过滤器匹配的路径。

参数
destDir File :放置下载内容的文件。

remoteFilePath String :要下载的文件的远程路径,相对于特定于实现的根。

includeFilters :用于下载匹配文件的过滤器列表。

excludeFilters :跳过下载匹配文件的过滤器列表。

投掷
BuildRetrievalError如果无法下载文件。
IO异常

新鲜

public boolean isFresh (File localFile, 
                String remoteFilePath)

检查本地文件的新鲜度。如果本地文件与远程文件相同,则它是新鲜的。如果不是,则本地文件已过时。这主要用于缓存。默认实现将始终返回 true,因此如果文件是不可变的,则它将永远不需要检查新鲜度。

参数
localFile File :本地文件。

remoteFilePath String :远程文件路径。

退货
boolean如果本地文件是最新的,则为 true,否则为 false。

投掷
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

释放下载许可

public void releaseDownloadPermit ()

如果支持并发限制,则释放下载许可。