断点续传下载
当下载大文件时,如果网络不稳定或者程序异常退出,会导致下载失败,甚至重试多次仍无法完成下载。为此 OSS 提供了断点续传下载功能。
断点续传下载将需要下载的文件分成若干个分片分别下载,所有分片都下载完成后,将所有分片合并成完整的文件。
您可以通过 OssClient .ResumableDownloadObject 方法实现断点续传下载。此方法的 DownloadObjectRequest 请求包含以下参数:
参数 | 描述 | 是否必需 | 默认值 | 如何设置 |
---|---|---|---|---|
bucket | 存储空间名称。 | 是 | 无 | 通过构造方法设置。 |
key | OSS文件名称。 | 是 | 无 | 通过构造方法设置。 |
filePath | 本地文件。OSS文件将下载到该文件。 | 否 | OSS文件名称 | 通过构造方法设置。 |
partSize | 分片大小,取值范围为100KB~5GB。 | 否 | 8MB | 通过setPartSize设置。 |
threadNum | 分片下载的并发数。 | 否 | 3 | 通过构造方法或者 setThreadNum 设置。 |
checkpointDir | 记录本地分片下载结果的文件。开启断点续传功能时需要设置此参数。下载过程中的进度信息会保存在该文件中,如果某一分片下载失败,再次下载时会根据文件中记录的点继续下载。下载完成后,该文件会被删除。 | 否 | 与DownloadFile同目录。 | 通过构造方法或者 setCheckpointDir 设置。 |
以下代码用于断点续传下载:
#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
{
/* 初始化OSS账号信息 */
std::string AccessKeyId = "yourAccessKeyId";
std::string AccessKeySecret = "yourAccessKeySecret";
std::string Endpoint = "yourEndpoint";
std::string BucketName = "yourBucketName";
std::string ObjectName = "yourObjectName";
std::string DownloadFilePath = "yourDownloadFilePath";
std::string CheckpointFilePath = "yourCheckpointFilepath"
/* 初始化网络等资源 */
InitializeSdk();
ClientConfiguration conf;
OssClient client(Endpoint, AccessKeyId, AccessKeySecret, conf);
/* 断点续传下载 */
DownloadObjectRequest request(BucketName, ObjectName, DownloadFilePath, CheckpointFilePath);
auto outcome = client.ResumableDownloadObject(request);
if (!outcome.isSuccess()) {
/* 异常处理 */
std::cout << "ResumableDownloadObject fail" <<
",code:" << outcome.error().Code() <<
",message:" << outcome.error().Message() <<
",requestId:" << outcome.error().RequestId() << std::endl;
ShutdownSdk();
return -1;
}
/* 释放网络等资源 */
ShutdownSdk();
return 0;
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论