Add transform and fopTimeout Put Policy

Author: ikbear

src/main/java/com/qiniu/api/rs/PutPolicy.java

@@ -47,6 +47,27 @@ public class PutPolicy {
 
 	public long deadline;
 
+  /**
+   *
+   * 对文件先进行一次变换操作（比如将音频统一转为某种码率的mp3）再进行存储。
+   * transform的值就是一个fop指令，比如 "avthumb/mp3"。其含义是对上传的文件
+   * 执行这个 fop 指令，然后把结果保存到七牛。最后保存的是经过处理过的文件，
+   * 而不是用户上传的原始文件。
+  **/
+  public String transform;
+
+  /**
+   *
+   * 单位： 秒
+   * 文件变换操作执行的超时时间（单位：秒），上传和转码操作是同步进行的，
+   * 先上传后转码，这个时间只是转码所需时间，不包括上传文件所需时间。
+   * 这个值太小可能会导致误判（最终存储成功了但客户端得到超时的错误），
+   * 但太大可能会导致服务端将其判断为低优先级任务。建议取一个相对准确的
+   * 时间估计值*N（N不要超过5）。
+   *
+  **/
+  public long fopTimeout;
+
 	public PutPolicy(String scope) {
 		this.scope = scope;
 	}
@@ -91,6 +112,12 @@ public String marshal() throws JSONException {
 		if (this.persistentOps != null && this.persistentOps.length() > 0) {
 			stringer.key("persistentOps").value(this.persistentOps);
 		}
+    if (this.transform != null && this.transform.length() > 0) {
+      stringer.key("transform").value(this.transform);
+    }
+    if (this.fopTimeout > 0) {
+      stringer.key("fopTimeout").value(this.fopTimeout);
+    }
 		stringer.key("deadline").value(this.deadline);
 		stringer.endObject();
 

src/test/java/com/qiniu/testing/IOTest.java

@@ -64,6 +64,26 @@ public void testPut() throws Exception {
 		}
 	}
 
+  /**
+   * 这个案例测试上传后转码并将转码结果保存为目标文件。例中使用了 PutPolicy 中的
+   * transform 和 fopTimeout 两个参数，分别对应要进行的转码操作和转码超时时间，
+   * 测试的时候请将例中的 localFile 改成合法的文件路径。
+  **/
+	public void testPutTransform() throws Exception {
+    PutPolicy putPolicy = new PutPolicy(bucketName);
+    putPolicy.transform = "avthumb/mp3";
+    putPolicy.fopTimeout = 60;
+
+    String uptoken = putPolicy.token(mac);
+		String localFile = "/Users/ikbear/7niu/music.mp4";
+    String key = "music-ikbear.mp3";
+
+		PutExtra extra = new PutExtra();
+		
+		PutRet ret = IoApi.putFile(uptoken, key, localFile, extra);
+		assertTrue(ret.ok());
+	}
+
 	@Override
 	public void tearDown() {
 		// delete the metadata from rs
@@ -89,4 +109,4 @@ public void tearDown() {
 			assertTrue(!sr.ok());
 		}
 	}
-}
+}