OBS客户端通用示例

回调函数返回结果：

OBS客户端可通过回调函数的形式返回结果，回调函数依次包含异常信息和SDK公共结果对象两个参数。如果回调函数中异常信息参数不为空，则表明接口调用异常；反之，则表明接口调用完成，此时应从SDK公共结果对象中获取HTTP状态码，判断操作是否成功。示例代码如下：

Promise对象返回结果：

OBS客户端可通过Promise对象返回结果，如果通过Promise对象的catch方法没有捕获到异常，则表明接口调用完成，此时应从SDK公共结果对象中获取HTTP状态码，判断操作是否成功。示例代码如下：

// 创建ObsClient实例
var obsClient = new ObsClient({
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
    // 前端本身没有process对象，可以使用webpack类打包工具定义环境变量，就可以在代码中运行了。
    // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    access_key_id: process.env.AccessKeyID,
    secret_access_key: process.env.SecretAccessKey,
    // 这里以华北-北京四为例，其他地区请按实际情况填写
    server: 'https://obs.cn-north-4.myhuaweicloud.com'
});

// 构造桶操作请求参数
var requestParam1 = {
       Bucket : 'bucketname'
       // 其他字段
};

// 调用桶操作接口，如获取桶区域位置
var promise1 = obsClient.getBucketLocation(requestParam1);
promise1.then((result) => {
   // 处理桶操作调用结果
}).catch((err)=>{
   // 处理错误
});

//构造对象操作请求参数
var requestParam2 = {
       Bucket : 'bucketname',
       Key : 'objectname'
       // 其他字段
};

// 调用对象操作接口，如下载对象
var promise2 = obsClient.getObject(requestParam2, callback2);
promise2.then((result) => {
   // 处理对象操作调用结果
}).catch((err)=>{
   // 处理错误
});

对于桶操作接口，请求对象中固定包含Bucket字段用于指定桶名；对于对象操作接口，请求对象中固定包含Bucket字段和Key字段分别用于指定桶名与对象名。

以下代码展示了使用Promise对象返回调用结果的通用示例：

// 引入obs库
var ObsClient = require('./lib/obs');

// 创建ObsClient实例
var obsClient = new ObsClient({
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
    // 前端本身没有process对象，可以使用webpack类打包工具定义环境变量，就可以在代码中运行了。
    // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    access_key_id: process.env.AccessKeyID,
    secret_access_key: process.env.SecretAccessKey,
    // 这里以华北-北京四为例，其他地区请按实际情况填写
    server: 'https://obs.cn-north-4.myhuaweicloud.com'
});

// 调用接口进行操作，例如上传对象
obsClient.putObject({
       Bucket : 'bucketname',
       Key : 'objectname',
       Body : 'Hello OBS'
}).then((result) => {
    // 接口调用完成，应进一步判断HTTP状态码
    if(result.CommonMsg.Status < 300){// 操作成功
        if(result.InterfaceResult){
            // 处理操作成功后业务逻辑
        }
    }else{// 操作失败，获取详细异常信息
        console.log('Code-->' + result.CommonMsg.Code); 
        console.log('Message-->' + result.CommonMsg.Message);
        console.log('HostId-->' + result.CommonMsg.HostId);
        console.log('RequestId-->' + result.CommonMsg.RequestId);
    }
}).catch((err) => {
    // 接口调用发生异常
    console.error('Error-->' + err);
});