文件下载器
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 | 如果文件无法下载 |
下载压缩文件
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 ()
如果支持并发限制,则释放下载许可。