Node.js端快速入门

  1. 初始化一个BosClient。

    BosClient是与BOS服务交互的客户端,BOS JavaScript SDK的BOS操作都是通过BosClient完成的。

    示例代码:

    var bce = require('@baiducloud/sdk');
    
    var config = {
        credentials: {
            ak: 'ak',       //您的AK
            sk: 'sk'        //您的SK
        },
        endpoint: <EndPoint>
    };
    
  2. 新建一个Bucket。

    Bucket是BOS上的命名空间,相当于数据的容器,可以存储若干数据实体(Object)。在您上传数据前,必须先创建一个Bucket。

    示例代码:

    let newBucketName = <BucketName>;    // 新建一个Bucket,指定Bucket名称
    client.createBucket(newBucketName)
      .then(function() {
             // 创建完成,添加您自已的代码;
       })
       .catch(function(error) {
            // 创建失败,添加您自己的代码,处理异常
       });
    
  3. 上传Object。

    Object是BOS中最基本的数据单元,您可以把Object简单的理解为文件。对于一个简单的Object的上传,BOS为您提供了四种方式:文件形式上传、数据流形式上传、二进制串上传和字符串上传。

    示例代码:

    function done(response) {
      // 上传完成
    }
    function fail(fail) {
      // 上传失败
    }
    
    // 以字符串形式上传
    client.putObjectFromString(bucket, object, 'hello world')
      .then(done)
      .catch(fail);
    
    // 以buffer形式上传
    var buffer = new Buffer('hello world'); client.putObject(bucket, object, buffer)
      .then(done)
      .catch(fail);
    
    // 以文件形式上传,仅支持Node.js环境
    client.putObjectFromFile(bucket, object, <path-to-file>)
      .then(done)
      .catch(fail);
    
    // 以blob对象形式上传,仅支持浏览器环境
    client.putObjectFromBlob(bucket, object, <blob对象>)
      .then(done)
      .catch(fail);
    
  4. 查看Bucket中的Object

    您可以参考如下代码来查看Bucket中的Object列表:

    client.listObjects(<bucketName>)
      .then(function (response) {
          var contents = response.body.contents;
          for (var i = 0, l = contents.length; i < l; i++) {
              console.log(contents[i].key);
          }
      })
      .catch(function (error) {
          // 查询失败
      });