全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
对象存储 OSS

断点续传下载

更新时间:2018-07-09 22:07:47

断点续传下载

当下载大文件时,如果网络不稳定或者程序异常退出,会导致下载失败,甚至重试多次仍无法完成下载。为此OSS提供了断点续传下载功能。

断点续传下载将需要下载的文件分成若干个分片分别下载,所有分片都下载完成后,将所有分片合并成完整的文件。

您可以通过ossClient.downloadFile方法实现断点续传下载。此方法的DownloadFileRequest请求包含以下参数:

参数 描述 是否必需 默认值 如何设置
bucket 存储空间名称。 通过构造方法设置。
key OSS文件名称。 通过构造方法设置。
downloadFile 本地文件。OSS文件将下载到该文件。 OSS文件名称 通过构造方法或setDownloadFile设置。
partSize 分片大小,取值范围为1B~5GB。 文件大小/10000 通过setPartSize设置。
taskNum 分片下载的并发数。 1 通过setTaskNum设置。
enableCheckpoint 是否开启断点续传功能。 关闭 通过setEnableCheckpoint设置。
checkpointFile 记录本地分片下载结果的文件。开启断点续传功能时需要设置此参数。下载过程中的进度信息会保存在该文件中,如果某一分片下载失败,再次下载时会根据文件中记录的点继续下载。下载完成后,该文件会被删除。 downloadFile.ucp(与DownloadFile同目录)。 通过setCheckpointFile设置。

以下代码用于断点续传下载:

  1. // Endpoint以杭州为例,其它Region请按实际情况填写。
  2. String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
  3. // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录 https://ram.console.aliyun.com 创建RAM账号。
  4. String accessKeyId = "<yourAccessKeyId>";
  5. String accessKeySecret = "<yourAccessKeySecret>";
  6. String bucketName = "<yourBucketName>";
  7. String objectName = "<yourObjectName>";
  8. // 创建OSSClient实例。
  9. OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
  10. // 下载请求,10个任务并发下载,启动断点续传。
  11. DownloadFileRequest downloadFileRequest = new DownloadFileRequest(bucketName, objectName);
  12. downloadFileRequest.setDownloadFile("<yourDownloadFile>");
  13. downloadFileRequest.setPartSize(1 * 1024 * 1024);
  14. downloadFileRequest.setTaskNum(10);
  15. downloadFileRequest.setEnableCheckpoint(true);
  16. downloadFileRequest.setCheckpointFile("<yourCheckpointFile>");
  17. // 下载文件。
  18. DownloadFileResult downloadRes = ossClient.downloadFile(downloadFileRequest);
  19. // 下载成功时,会返回文件元信息。
  20. downloadRes.getObjectMeta();
  21. // 关闭OSSClient。
  22. ossClient.shutdown();
本文导读目录