本文介绍使用 TOS SDK 时的异常处理。
TOS 服务端遵循 HTTP 规范，对于请求失败的场景定义了详细的 HTTP 状态码和业务错误码。详细内容请参见 TOS 服务端状态码和错误码定义。
当客户端输入参数有误、发生错误需要取消断点续传上传等场景的会报客户端错误。例如创建桶时，如果桶名字符长度大于 63 个字符则返回错误中 isClientError 参数为 true，标识发生了客户端错误。
通过 TOS C++ SDK 接口向 TOS 服务端发送请求，请求响应中会包含遵循 HTTP 规范的状态码和业务错误码，用于标识当前请求的响应状态，同时 isClientError 参数的值为 false。
以下代码展示了下载一个的对象，然后针对客户端返回值处理，若为服务端错误则可以打印 HTTP 请求状态码、错误信息、请求的 RequestId 和 HostId，若为客户端错误则可以打印错误消息。
#include "TosClientV2.h"
using namespace VolcengineTos;
int main(void){
// 初始化 TOS 账号信息
// Your Region 填写 Bucket 所在 Region
std::string region = "Your Region";
std::string accessKey = std::getenv("TOS_ACCESS_KEY");
std::string secretKey = std::getenv("TOS_SECRET_KEY");
// 填写 Bucket 名称，例如 examplebucket
std::string bucketName = "examplebucket";
// 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
std::string objectName = "exampledir/exampleobject.txt";
// 初始化网络等资源
InitializeClient();
// 创建交互的 client
TosClientV2 client(region, accessKey, secretKey);
GetObjectV2Input input(bucketName, objectName);
auto output = client.getObject(input);
if (!output.isSuccess()) {
auto error = output.error();
if(error.isClientError()){
// 客户端错误
std::cout << "TosClientError: {message=" << error.getMessage() << "}";
} else {
// 服务端错误
std::cout << "TosServerError: {statusCode=" << error.getStatusCode() << ", "
<< "code=" << error.getCode() << ", "
<< "message=" << error.getMessage() << ", "
<< "requestID=" << error.getRequestId() << ", "
<< "hostID=" << error.getHostId() << "}";
}
// 释放网络等资源
CloseClient();
return -1;
}
std::cout << "GetObject success. the object etag:" << output.result().getETags() << std::endl;
// 释放网络等资源
CloseClient();
return 0;
}