test&doc

Author: lintianzhi

docs/README.gist.md

@@ -333,6 +333,19 @@ PutExtra是上传时的可选信息，默认为null
 ### 云处理
 
 <a云处理使用说明\>
+
+#### pfop
+`pfop`的作用是对已存在七牛服务器上的文件做持久化的fop，具体见[api文档](http://developer.qiniu.com/docs/v6/api/overview/fop/persistent-fop.html)
+
+```{javascript}
+// 原型
+func pfop(bucketName, keyName, fops, opts, callback);
+
+// 例子
+@gist(../test/io.test.js#pfop)
+
+```
+
 #### 查看图像信息
 
 ```{javascript}

docs/README.md

@@ -529,6 +529,23 @@ qiniu.rsf.listPrefix(bucketname, prefix, marker, limit, function(err, ret) {
 ### 云处理
 
 <a云处理使用说明\>
+
+#### pfop
+`pfop`的作用是对已存在七牛服务器上的文件做持久化的fop，具体见[api文档](http://developer.qiniu.com/docs/v6/api/overview/fop/persistent-fop.html)
+
+```{javascript}
+// 原型
+func pfop(bucketName, keyName, fops, opts, callback);
+
+// 例子
+// pfop
+      qiniu.fop.pfop(TEST_BUCKET, keys[0], 'avinfo', {notifyUrl: 'www.test.com', force: true}, function(err, ret) {
+        ret.should.have.keys('persistentId');
+        done();
+      });
+
+```
+
 #### 查看图像信息
 
 ```{javascript}

qiniu/fop.js

@@ -51,10 +51,14 @@ Exif.prototype.makeRequest = function(url) {
 }
 
 
-function pfop(bucket, key, fops, notify, onret) {
+function pfop(bucket, key, fops, opts, onret) {
+
+  opts = opts || {};
+  var notifyStr = '&notifyURL=' + opts.notifyURL || '';
+  var forceStr = opts.force && '&force=1' || '';
 
   var uri = 'http://api.qiniu.com/pfop/';
-  var body = 'bucket='+bucket+'&key='+key+'&fops='+fops+'&notifyURL='+notify;
+  var body = 'bucket='+bucket+'&key='+key+'&fops='+fops+ notifyStr + forceStr;
   var auth = util.generateAccessToken(uri, body);
   rpc.postWithForm(uri, body, auth, onret);
 }

test/io.test.js

@@ -133,4 +133,16 @@ describe('test start step1:', function() {
       });
     });
   });
+
+  describe('pfop', function() {
+    it('do pfop', function(done) {
+// @gist pfop
+// pfop
+      qiniu.fop.pfop(TEST_BUCKET, keys[0], 'avinfo', {notifyUrl: 'www.test.com', force: true}, function(err, ret) {
+        ret.should.have.keys('persistentId');
+        done();
+      });
+// @endgist
+    })
+  });
 });