文档首页 > > SDK参考> C> 上传对象> 断点续传上传

断点续传上传

分享
更新时间: 2019/09/11 GMT+08:00

当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败,其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则抛出异常提醒用户再次调用接口进行重新上传(重新上传时因为有checkpoint文件记录当前的上传进度,避免重新上传所有分段,从而节省资源提高效率)。

您可以通过upload_file进行断点续传上传。该接口可设置的参数如下:

参数描述

字段名

类型

约束

说明

option↵

请求桶的上下文,配置option

必选

桶参数。

key

char *

必选

对象名。

upload_file_config

obs_upload_file_configuration *

必选

上传文件的配置说明,请参看下表。

encryption_params

server_side_encryption_params *

可选

上传对象加密设置。

handler

obs_upload_file_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

上传文件结构obs_upload_file_configuration描述如下表:

成员名

类型

约束

说明

upload_file

char *

必选

待上传的本地文件。

part_size

uint64_t

必选

分段大小,单位字节,取值范围是5MB~5GB,默认为5MB。

check_point_file

char *

必选

记录上传进度的文件,只在断点续传模式下有效。当该值为空时,默认与待上传的本地文件同目录。

enable_check_point

int

必选

是否开启断点续传模式,默认为0,表示不开启。

task_num

int

必选

分段上传时的最大并发数,默认为1。

示例代码

以下代码展示了如何使用断点续传上传接口上传文件:

static void test_upload_file()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    // 创建并初始化option
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";
    option.bucket_options.access_key = "<Your AK>";
    option.bucket_options.secret_access_key = "<Your SK>";
    //初始化结构体put_properties
    obs_put_properties put_properties;
    init_put_properties(&put_properties);

    obs_upload_file_configuration uploadFileInfo;
    memset_s(&uploadFileInfo,sizeof(obs_upload_file_configuration),0,sizeof(obs_upload_file_configuration));
    uploadFileInfo.check_point_file = 0;
    uploadFileInfo.enable_check_point = 1;
    uploadFileInfo.part_size = "<part size>";
    uploadFileInfo.task_num = "<task num>";
    uploadFileInfo.upload_file = "<upload filename>";

    //回调函数
    obs_upload_file_response_handler Handler =
    { 
        {&response_properties_callback, &response_complete_callback},
        &uploadFileResultCallback
    };    
    initialize_break_point_lock();upload_file(&option, "<Your Key>", 0, &uploadFileInfo, &Handler, &ret_status);
    deinitialize_break_point_lock();
    if (OBS_STATUS_OK == ret_status) {
        printf("test upload file successfully. \n");
    }
    else
    {
        printf("test upload file faied(%s).\n", obs_get_status_name(ret_status));
    }
}
说明:
  • 断点续传上传接口是利用分段上传特性实现的,是对分段上传的封装和加强。
  • 断点续传上传接口不仅能在失败重传时节省资源提高效率,还因其对分段进行并发上传的机制能加快上传速度,帮助用户快速完成上传业务;且其对用户透明,用户不用关心checkpoint文件的创建和删除、分段任务的切分、并发上传的实现等内部细节。
  • enable_check_point参数:0代表不启用断点续传模式,此时断点续传上传接口退化成对分段上传的简单封装,不会产生checkpoint文件,1代表启用断点续传模式。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区