C++ SDK

注意：

您目前查阅的是历史版本 SDK 文档，已不再更新和维护，我们建议您查阅新版 SDK 文档。

开发准备

相关资源

Github 项目下载地址

开发环境

1. 安装 openssl 的库和头文件。
2. 安装 curl 的库和头文件。
3. 安装 jsoncpp 的库和头文件。
4. 安装 boost 的库和头文件。
5. 安装 cmake 工具。
6. 登录 腾讯云控制台 获取 APPID、SecretID、SecretKey。

注意：

1. 本 SDK 仅适用于 Linux 系统和编译环境，暂不支持 Windows 环境。
2. sdk 中提供了curl 和 jsoncpp 的库以及头文件，以上库编译好后替换掉 sdk 中相应的库和头文件即可，如果以上库已经安装到系统里，也可删除 sdk 中相应的库和头文件。
3. curl 默认不支持多线程环境，如果项目使用多线程，在编译 curl 执行 configure 时需指定 --enable-ares 参数来开启异步 DNS 解析，依赖 c-ares 库，如果系统没有，可到 c-ares 下载安装。
4. jsoncpp 的 1.y.x 版本需要 c++11 的支持，如果编译器不支持，可以换成 0.y.x 版本。
   （本版本 SDK 基于 JSON API 封装组成）

SDK 配置

直接下载 github 上提供的源代码，集成到您的开发环境。

执行下面的命令 ：

cd ${cos-cpp-sdk} 
mkdir -p build 
cd build 
cmake .. 
make 

cos_demo.cpp 里面有常见 API 的例子。生成的 cos_demo 可以直接运行，生成的静态库名称为：libcossdk.a。生成的 libcossdk.a 放到您自己的工程里 lib 路径下，include 目录拷贝到自己的工程的 include 路径下。

生成签名

多次有效签名

方法原型

static string AppSignMuti(const uint64_t appId, 
                          const string &secretId, 
                          const string &secretKey, 
                          const uint64_t expired_time, 
                          const string &bucketName); 

参数说明

返回结果说明

返回值：签名字符串

示例

uint64_t expired = time(NULL) + 60;
string sign = Auth::AppSignMuti(10000000,"SecretId","SecretKey",expired,"bucketName");

单次有效签名

方法原型

static string AppSignOnce(const uint64_t appId, 
                          const string &secretId, 
                          const string &secretKey, 
                          const string &path, 
                          const string &bucketName); 

参数说明

返回值说明

返回值：签名字符串

示例

string path= "/myFloder/myFile.rar";
sign = Auth::AppSignOnce(10000000, "SecretId", "SecretKey", path, bucketName);

初始化操作

初始化

接口说明：在使用 COS 操作之前，需要首先进行 COS 系统参数的设置，然后分别创建 CosConfig 以及 CosAPI 对象，COS 的操作都是基于 CosAPI 对象进行的。

配置文件

"AppID":********,
"SecretID":"*********************************",
"SecretKey":"********************************",
"Region":"sh",   //COS区域, 华东园区：sh ；华南园区：gz ；华北园区：tj ；上传和下载域名均是跟此有关系，因此一定要保证正确
"SignExpiredTime":360, //签名超时时间
"CurlConnectTimeoutInms":180,  //http超时时间
"CurlGlobalConnectTimeoutInms":360, //
"UploadSliceSize":1048576, //文件分片大小，可选值有524288、1048576、2097152、3145728
"IsUploadTakeSha":0, //文件上传时是否携带文件sha值，0：不携带，1：携带
"DownloadDomainType":2, //下载域名类型,1:cdn,2:cos,3:innercos,4:自定义域名
"SelfDomain":"",//自定义域名
"UploadThreadPoolSize":5, //单文件分片上传线程池大小
"AsynThreadPoolSize":2, //异步上传下载线程池大小
"LogoutType":1 //日志输出类型,0:不输出,1:输出到屏幕,2输出到syslog

COS API 对象构造原型

CosConfig(const string& config_file);
CosAPI(CosConfig& config);

目录操作

创建目录

接口说明：用于目录的创建，调用者可以通过此接口在指定 bucket 下创建目录。

方法原型

string CosAPI::FolderCreate(FolderCreateReq& request);        

参数说明

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FolderCreateReq folderCreateReq(bucket,folder,folder_biz_attr);
string rsp = cos.FolderCreate(folderCreateReq);

目录更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

string FolderUpdate(FolderUpdateReq& request);                    

参数说明

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FolderUpdateReq folderUpdateReq(bucket,folder, folder_biz_attr);
string rsp = cos.FolderUpdate(folderUpdateReq);

目录查询

接口说明：用于目录属性的查询，可以通过此接口查询目录的属性。

方法原型

string CosAPI::FolderStat(FolderStatReq& request);

参数说明

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FolderStatReq folderStatReq(bucket,folder);
string rsp = cos.FolderStat(folderStatReq);

目录删除

接口说明：用于目录的删除，可以通过此接口删除空目录，如果目录中存在有效文件或目录，将不能删除。

方法原型

string CosAPI::FolderDelete(FolderDeleteReq& request);

参数说明

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FolderDeleteReq folderDeleteReq(bucket,folder);
string rsp = cos.FolderDelete(folderDeleteReq);

目录列表

接口说明：用于列举目录下文件和目录，可以通过此接口查询目录下的文件和目录属性。

方法原型

string CosAPI::FolderList(FolderListReq& request);

参数说明

返回结果说明

通过函数返回值返回请求结果的 json 字符串

示例

FolderListReq folderListReq(bucket,folder);
string rsp = cos.FolderList(folderListReq);

文件操作

文件上传

接口说明：文件上传，包括单文件上传和分片上传（大于8M的文件需要通过将文件内容进行分片上传）。

方法原型

string CosAPI::FileUpload(FileUploadReq& request);

参数说明

返回结果说明

通过函数返回值返回请求结果的 json 字符串

示例

FileUploadReq fileUploadReq(bucket, srcPath, dstPath);
string rsp = cos.FileUpload(fileUploadReq);

文件更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

string CosAPI::FileUpdate(FileUpdateReq& request);

参数说明

custom_header说明

tips: custom_header 是整体覆盖式更新，即更新属性可以选择其中的某几个，如果本次只更新其中的某几个，其他的都会被抹掉。

返回结果说明

通过函数返回值返回请求结果的json字符串：

示例

FileUpdateReq fileUpdateReq(bucket,dstpath);
fileUpdateReq.setBizAttr(file_biz_attr);
fileUpdateReq.setAuthority(auth);
fileUpdateReq.setForbid(0);
fileUpdateReq.setCustomHeader(custom_header);
string rsp = cos.FileUpdate(fileUpdateReq);

文件查询

接口说明：用于文件的查询，可以通过此接口查询文件的各项属性信息。

方法原型

string CosAPI::FileStat(FileStatReq& request)

参数说明

FileStatReq

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FileStatReq fileStatReq(bucket,dstpath);
string rsp = cos.FileStat(fileStatReq);

文件删除

接口说明：用于文件的删除，可以通过此接口删除已经上传的文件。

方法原型

FileDeleteReq fileDeleteReq(bucket,dstpath);
string rsp = cos.FileDelete(fileDeleteReq);

参数说明

FolderDeleteReq

返回结果说明

通过函数返回值返回请求结果的json字符串

示例

FileDeleteReq fileDeleteReq(bucket,dstpath);
string rsp = cos.FileDelete(fileDeleteReq);