基于Promise的又拍云Node.js SDK

又拍云官方提供了一个Node.js版本的sdk，但有下面几个问题：

• 没有放在npm里，需要自己去下载
• 接口功能太简单，需要自己写很多（如：删除目录先要清空该目录下的文件才能删除，清空操作只能自己去实现）

基于此，基于Promise重新写了个又拍云的sdk。

安装

• 安装
• 使用
  • getUsage(path)
  • upload(savePath, filePath, headers)
  • download(soucePath, savePath)
  • rm(path, force)
  • mkDir(path)
  • readDir(path, recursive)
  • getInfo(path)

npm install node-upyun-sdk

源代码：https://github.com/welefen/node-upyun-sdk

使用

var upyun = require("node-upyun-sdk");
    var instance = upyun("bucketname", "username", "password");

下面的所有接口返回的都是一个promise，可以通过下面的方式来获取返回值和捕获错误：

instance.getUsage("/").then(function(data){
        console.log(data);
    }).catch(function(error){
        console.log(error);
    })

getUsage(path)

• path string 目录名

获取目录的空间占用信息

instance.getUsage("/"); //获取根目录的空间使用情况
    instance.getUsage("/foo/bar"); //获取/foo/bar目录的空间使用情况

upload(savePath, filePath, headers)

• savePath string 又拍云上存放的目录
• filePath string 本地要上传的目录
• headers object|string 附带的headers

文件或者文件夹上传

instance.upload("/aaa/", "img/c.jpg"); //将c.jpg文件上传到/aaa/下，保存的文件名为c.jpg
    instance.upload("/aaa/a.jpg", "img/c.jpg"); //下c.jpg文件上传到/aaa/下，重新设置文件名为a.jpg
    instance.upload("/aaa", "img/"); //将img/下的所有文件上传到/aaa目录下
    instance.upload("/aaa/a.jpg", "img/c.jpg", "welefen"); //设置文件的Content-Secret上传
    instance.upload("/aaa/a.jpg", "img/c.jpg", {
        "x-gmkerl-type": "fix_width",
        "x-gmkerl-value": 150
    }); //设置图片处理信息

download(soucePath, savePath)

• sourcePath string 又拍云上的目录
• savePath string 存储的目录

文件或者文件夹下载

instance.download("/aaa", "img/"); //将/aaa目录下的文件下载到img目录下，包含子目录
    instance.download("/aaa/a.jpg", "img/"); //将a.jpg文件下载到img目录下
    instacen.download("/aaa/a.jpg", "img/c.jpg"); //将a.jpg文件下载到img目录并重命名为c.jpg

rm(path, force)

• path string 要删除的文件夹或者文件
• force boolean 是否强制删除，强制后会递归删除目录下所有的文件

删除文件或者文件夹

instance.rm("/aaa"); //删除/aaa目录，/aaa目录下必须为空
    instance.rm("/aaa", true); //删除/aaa目录，如果/aaa下有子目录或者文件，先删除这些子目录和文件
    instance.rm("/aaa/a.jpg"); //删除a.jpg文件

mkDir(path)

• path string 要创建的目录

创建目录

instance.mkDir("/aaa/bbb"); //递归的创建/aaa/bbb目录

readDir(path, recursive)

• path string 要读取的文件夹
• recursive boolean 是否是递归方式，递归方式数据里会有children字段信息

获取文件夹下的文件和子目录信息

instance.readDir("/aaa"); //获取/aaa目录下的文件和子目录
    instance.readDir("/aaa", true); //获取/aaa目录下的文件和子目录，包含子目录详细信息

getInfo(path)

• path string 要获取信息的path

获取文件或者文件夹的信息

instance.getInfo("/aaa"); //获取/aaa文件夹的信息
    instance.getInfo("/aaa/a.jpg"); //获取a.jpg文件的信息