Java SDK

{"value":"# \u7b80\u4ecb\n\n\u6b64 SDK \u9002\u7528\u4e8e Java 8 \u53ca\u4ee5\u4e0a\u7248\u672c\u3002\u4f7f\u7528\u6b64 SDK \u6784\u5efa\u60a8\u7684\u7f51\u7edc\u5e94\u7528\u7a0b\u5e8f\uff0c\u80fd\u8ba9\u60a8\u4ee5\u975e\u5e38\u4fbf\u6377\u5730\u65b9\u5f0f\u5c06\u6570\u636e\u5b89\u5168\u5730\u5b58\u50a8\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e0a\u3002\u65e0\u8bba\u60a8\u7684\u7f51\u7edc\u5e94\u7528\u662f\u4e00\u4e2a\u7f51\u7ad9\u7a0b\u5e8f\uff0c\u8fd8\u662f\u5305\u62ec\u4ece\u4e91\u7aef\uff08\u670d\u52a1\u7aef\u7a0b\u5e8f\uff09\u5230\u7ec8\u7aef\uff08\u624b\u6301\u8bbe\u5907\u5e94\u7528\uff09\u7684\u67b6\u6784\u670d\u52a1\u6216\u5e94\u7528\uff0c\u901a\u8fc7\u79c1\u6709\u4e91\u5b58\u50a8\u53ca\u5176 SDK\uff0c\u90fd\u80fd\u8ba9\u60a8\u5e94\u7528\u7a0b\u5e8f\u7684\u7ec8\u7aef\u7528\u6237\u9ad8\u901f\u4e0a\u4f20\u548c\u4e0b\u8f7d\uff0c\u540c\u65f6\u4e5f\u8ba9\u60a8\u7684\u670d\u52a1\u7aef\u66f4\u52a0\u8f7b\u76c8\u3002\n\nJava SDK \u5c5e\u4e8e\u5b58\u50a8\u670d\u52a1\u7aefSDK\u4e4b\u4e00\uff0c\u4e3b\u8981\u6709\u5982\u4e0b\u529f\u80fd\uff1a\n\n1. \u63d0\u4f9b\u751f\u6210\u5ba2\u6237\u7aef\u4e0a\u4f20\u6240\u9700\u7684\u4e0a\u4f20\u51ed\u8bc1\u7684\u529f\u80fd\n2. \u63d0\u4f9b\u6587\u4ef6\u4ece\u670d\u52a1\u7aef\u76f4\u63a5\u4e0a\u4f20\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u529f\u80fd\n3. \u63d0\u4f9b\u5bf9\u79c1\u6709\u4e91\u5b58\u50a8\u7a7a\u95f4\u4e2d\u6587\u4ef6\u8fdb\u884c\u7ba1\u7406\u7684\u529f\u80fd\n4. \u63d0\u4f9b\u5bf9\u79c1\u6709\u4e91\u5b58\u50a8\u7a7a\u95f4\u4e2d\u6587\u4ef6\u8fdb\u884c\u5904\u7406\u7684\u529f\u80fd\n\n\n\n# \u5f00\u6e90\n\n- [Java SDK \u9879\u76ee\u5730\u5740](https:\/\/github.com\/CDNCloudForU\/java-sdk)\n- [Java SDK \u53d1\u5e03\u5730\u5740](https:\/\/github.com\/CDNCloudForU\/java-sdk\/releases)\n- [Java SDK \u5386\u53f2\u6587\u6863](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/sdk\/java-sdk-6.md)\n\n\n\n# \u5b89\u88c5\n\n## \u6ce8\u610f\n\n- \u4ece 7.2.24 \u5f00\u59cb\uff0cokhttp3 \u5347\u7ea7\u5230 3.14.2\uff0c\u5176\u8981\u6c42 java 1.8 \u53ca\u4ee5\u4e0a\u3002\n\n- \u82e5\u4e00\u5b9a java 1.7 \uff0c\u8bf7\u624b\u52a8\u6307\u5b9a okhttp3 \u4f9d\u8d56 3.12\uff0c\u8981\u6c42 3.12.3 \u53ca\u4ee5\u4e0a\uff0c\n\n \n\n ```\n com.squareup.okhttp3:okhttp:3.12.3\n ```\n\n ```\n compile ('com.qiniu:qiniu-java-sdk:7.7.0') {\n exclude group: 'com.squareup.okhttp3', module: 'okhttp'\n }\n compile 'com.squareup.okhttp3:okhttp:3.12.6'\n ```\n\n\n\n### Gradle\n\n```\ncompile 'com.qiniu:qiniu-java-sdk:7.7.+'\n```\n\n\n\n### Maven\n\n```\n<dependency>\n <groupId>com.qiniu<\/groupId>\n <artifactId>qiniu-java-sdk<\/artifactId>\n <version>[7.7.0, 7.10.99]<\/version>\n<\/dependency>\n```\n\n\u8fd9\u91cc\u7684`version`\u6307\u5b9a\u4e86\u4e00\u4e2a\u7248\u672c\u8303\u56f4\uff0c\u6bcf\u6b21\u66f4\u65b0`pom.xml`\u7684\u65f6\u5019\u4f1a\u5c1d\u8bd5\u53bb\u4e0b\u8f7d`7.7.x`\u7248\u672c\u4e2d\u7684\u6700\u65b0\u7248\u672c\uff0c\u4f60\u53ef\u4ee5\u624b\u52a8\u6307\u5b9a\u4e00\u4e2a\u56fa\u5b9a\u7684\u7248\u672c\u3002\n\n### \u624b\u52a8\u4e0b\u8f7d\n\n\u8bf7\u5c3d\u91cf\u4f7f\u7528\u5305\u7ba1\u7406\u5de5\u5177\u81ea\u52a8\u89e3\u51b3\u4f9d\u8d56\u95ee\u9898\u3002\u5982\u679c\u6761\u4ef6\u5b9e\u5728\u4e0d\u6ee1\u8db3\uff0c\u53ea\u80fd\u901a\u8fc7\u624b\u52a8\u4e0b\u8f7djar\u5305\u7684\u65b9\u5f0f\u6765\u89e3\u51b3\u3002\u672c\u9879\u76ee\u81ea\u8eabjar\u53ca\u4f9d\u8d56\u7684\u7b2c\u4e09\u65b9\u5e93\u5982\u4e0b\uff1a\n\nJava SDK\u4f9d\u8d56\u7684\u7b2c\u4e09\u65b9\u5e93\u53ca\u5176\u7248\u672c\u5982\u4e0b\uff1a\n\n```\n<dependencies>\n <dependency>\n <groupId>com.squareup.okhttp3<\/groupId>\n <artifactId>okhttp<\/artifactId>\n <version>3.14.2<\/version>\n <scope>compile<\/scope>\n <\/dependency>\n <dependency>\n <groupId>com.google.code.gson<\/groupId>\n <artifactId>gson<\/artifactId>\n <version>2.8.5<\/version>\n <scope>compile<\/scope>\n <\/dependency>\n <dependency>\n <groupId>com.qiniu<\/groupId>\n <artifactId>happy-dns-java<\/artifactId>\n <version>0.1.6<\/version>\n <scope>test<\/scope>\n <\/dependency>\n <dependency>\n <groupId>junit<\/groupId>\n <artifactId>junit<\/artifactId>\n <version>4.12<\/version>\n <scope>test<\/scope>\n <\/dependency>\n <\/dependencies>\n```\n\n| \u5e93\u540d\u79f0 | \u5e93\u9879\u76ee\u5730\u5740 | \u5e93\u4e0b\u8f7d\u5730\u5740 |\n| -------------- | ------------------------------------------------------- | ------------------------------------------------------------ |\n| qiniu-java-sdk | [\u94fe\u63a5\ud83d\udd17](https:\/\/github.com\/CDNCloudForU\/java-sdk) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=a:qiniu-java-sdk&smo=true)) |\n| happy-dns-java | [\u94fe\u63a5\ud83d\udd17](https:\/\/github.com\/CDNCloud-com\/happy-dns-java) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=a:happy-dns-java&smo=true) |\n| okhttp3 | [\u94fe\u63a5\ud83d\udd17](https:\/\/github.com\/square\/okhttp) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=g:com.squareup.okhttp3&smo=true) |\n| okio | [\u94fe\u63a5\ud83d\udd17](https:\/\/github.com\/square\/okio) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=g:com.squareup.okio&smo=true) |\n| gson | [\u94fe\u63a5\ud83d\udd17](https:\/\/github.com\/google\/gson) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=g:com.squareup.okio&smo=true) |\n| junit | [\u94fe\u63a5\ud83d\udd17](http:\/\/junit.org\/junit4\/) | [\u94fe\u63a5\ud83d\udd17](https:\/\/central.sonatype.com\/search?q=g:com.squareup.okio&smo=true) |\n\n\u53ef\u4ee5\u70b9\u51fb\u6bcf\u4e2a\u5e93\u7684\u4e0b\u8f7d\u94fe\u63a5\uff0c\u7136\u540e\u9009\u62e9\u5bf9\u5e94\u7684jar\u8fdb\u884c\u4e0b\u8f7d\uff0c\u7136\u540e\u5f15\u5165\u5230\u9879\u76ee\u4e2d\u3002\n# \u9274\u6743\n\nJava SDK\u7684\u6240\u6709\u7684\u529f\u80fd\uff0c\u90fd\u9700\u8981\u5408\u6cd5\u7684\u6388\u6743\u3002\u6388\u6743\u51ed\u8bc1\u7684\u7b7e\u7b97\u9700\u8981\u79c1\u6709\u4e91\u5b58\u50a8\u8d26\u53f7\u4e0b\u7684\u4e00\u5bf9\u6709\u6548\u7684`Access Key`\u548c`Secret Key`\uff0c\u8fd9\u5bf9\u5bc6\u94a5\u53ef\u4ee5\u901a\u8fc7\u5982\u4e0b\u6b65\u9aa4\u83b7\u5f97\uff1a\n\n1. \u5f00\u901a\u79c1\u6709\u4e91\u5b58\u50a8\u5f00\u53d1\u8005\u5e10\u53f7\n2. \u5982\u679c\u5df2\u6709\u8d26\u53f7\uff0c\u76f4\u63a5\u767b\u5f55\u79c1\u6709\u4e91\u5b58\u50a8\u5f00\u53d1\u8005\u540e\u53f0\uff0c\u67e5\u770b Access Key \u548c Secret Key\n\n\n\n# \u6587\u4ef6\u4e0a\u4f20\n\n\n\n### \u4e0a\u4f20\u6d41\u7a0b\n\n\u6587\u4ef6\u4e0a\u4f20\u5206\u4e3a\u5ba2\u6237\u7aef\u4e0a\u4f20\uff08\u4e3b\u8981\u662f\u6307\u7f51\u9875\u7aef\u548c\u79fb\u52a8\u7aef\u7b49\u9762\u5411\u7ec8\u7aef\u7528\u6237\u7684\u573a\u666f\uff09\u548c\u670d\u52a1\u7aef\u4e0a\u4f20\u4e24\u79cd\u573a\u666f\uff0c\u5177\u4f53\u53ef\u4ee5\u53c2\u8003\u6587\u6863[\u4e1a\u52a1\u6d41\u7a0b](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/manual\/1205\/programming-model.html)\u3002\n\n\u670d\u52a1\u7aefSDK\u5728\u4e0a\u4f20\u65b9\u9762\u4e3b\u8981\u63d0\u4f9b\u4e24\u79cd\u529f\u80fd\uff0c\u4e00\u79cd\u662f\u751f\u6210\u5ba2\u6237\u7aef\u4e0a\u4f20\u6240\u9700\u8981\u7684\u4e0a\u4f20\u51ed\u8bc1\uff0c\u53e6\u5916\u4e00\u79cd\u662f\u76f4\u63a5\u4e0a\u4f20\u6587\u4ef6\u5230\u4e91\u7aef\u3002\n\n\n\n### \u5ba2\u6237\u7aef\u4e0a\u4f20\u51ed\u8bc1\n\n\u5ba2\u6237\u7aef\uff08\u79fb\u52a8\u7aef\u6216\u8005Web\u7aef\uff09\u4e0a\u4f20\u6587\u4ef6\u7684\u65f6\u5019\uff0c\u9700\u8981\u4ece\u5ba2\u6237\u81ea\u5df1\u7684\u4e1a\u52a1\u670d\u52a1\u5668\u83b7\u53d6\u4e0a\u4f20\u51ed\u8bc1\uff0c\u800c\u8fd9\u4e9b\u4e0a\u4f20\u51ed\u8bc1\u662f\u901a\u8fc7\u670d\u52a1\u7aef\u7684SDK\u6765\u751f\u6210\u7684\uff0c\u7136\u540e\u901a\u8fc7\u5ba2\u6237\u81ea\u5df1\u7684\u4e1a\u52a1API\u5206\u53d1\u7ed9\u5ba2\u6237\u7aef\u4f7f\u7528\u3002\u6839\u636e\u4e0a\u4f20\u7684\u4e1a\u52a1\u9700\u6c42\u4e0d\u540c\uff0c\u79c1\u6709\u4e91\u5b58\u50a8Java SDK\u652f\u6301\u4e30\u5bcc\u7684\u4e0a\u4f20\u51ed\u8bc1\u751f\u6210\u65b9\u5f0f\u3002\n\n\n\n#### \u7b80\u5355\u4e0a\u4f20\u7684\u51ed\u8bc1\n\n\u6700\u7b80\u5355\u7684\u4e0a\u4f20\u51ed\u8bc1\u53ea\u9700\u8981`AccessKey`\uff0c`SecretKey`\u548c`Bucket`\u5c31\u53ef\u4ee5\u3002\n\n```\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nString upToken = auth.uploadToken(bucket);\nSystem.out.println(upToken);\n```\n\n\n\n#### \u8986\u76d6\u4e0a\u4f20\u7684\u51ed\u8bc1\n\n\u8986\u76d6\u4e0a\u4f20\u9664\u4e86\u9700\u8981`\u7b80\u5355\u4e0a\u4f20`\u6240\u9700\u8981\u7684\u4fe1\u606f\u4e4b\u5916\uff0c\u8fd8\u9700\u8981\u60f3\u8fdb\u884c\u8986\u76d6\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8fd9\u4e2a\u6587\u4ef6\u540d\u79f0\u540c\u65f6\u53ef\u662f\u5ba2\u6237\u7aef\u4e0a\u4f20\u4ee3\u7801\u4e2d\u6307\u5b9a\u7684\u6587\u4ef6\u540d\uff0c\u4e24\u8005\u5fc5\u987b\u4e00\u81f4\u3002\n\n```\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\nString key = \"file key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nString upToken = auth.uploadToken(bucket, key);\nSystem.out.println(upToken);\n```\n\n\n\n#### \u81ea\u5b9a\u4e49\u4e0a\u4f20\u56de\u590d\u7684\u51ed\u8bc1\n\n\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6587\u4ef6\u4e0a\u4f20\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e4b\u540e\uff0c\u5728\u6ca1\u6709\u8bbe\u7f6e`returnBody`\u6216\u8005`\u56de\u8c03`\u76f8\u5173\u7684\u53c2\u6570\u60c5\u51b5\u4e0b\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u8fd4\u56de\u7ed9\u4e0a\u4f20\u7aef\u7684\u56de\u590d\u683c\u5f0f\u4e3a`hash`\u548c`key`\uff0c\u4f8b\u5982\uff1a\n\n```\n{\"hash\":\"Ftgm-CkWePC9fzMBTRNmPMhGBcSV\",\"key\":\"qiniu.jpg\"}\n```\n\n\u6709\u65f6\u5019\u6211\u4eec\u5e0c\u671b\u80fd\u81ea\u5b9a\u4e49\u8fd9\u4e2a\u8fd4\u56de\u7684JSON\u683c\u5f0f\u7684\u5185\u5bb9\uff0c\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e`returnBody`\u53c2\u6570\u6765\u5b9e\u73b0\uff0c\u5728`returnBody`\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u79c1\u6709\u4e91\u5b58\u50a8\u652f\u6301\u7684[\u9b54\u6cd5\u53d8\u91cf](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/manual\/1235\/vars.html#magicvar)\u548c[\u81ea\u5b9a\u4e49\u53d8\u91cf](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/manual\/1235\/vars.html#xvar)\u3002\n\n```\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nStringMap putPolicy = new StringMap();\nputPolicy.put(\"returnBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize)}\");\nlong expireSeconds = 3600;\nString upToken = auth.uploadToken(bucket, null, expireSeconds, putPolicy);\nSystem.out.println(upToken);\n```\n\n\u5219\u6587\u4ef6\u4e0a\u4f20\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e4b\u540e\uff0c\u6536\u5230\u7684\u56de\u590d\u5185\u5bb9\u5982\u4e0b\uff1a\n\n```\n{\"key\":\"qiniu.jpg\",\"hash\":\"Ftgm-CkWePC9fzMBTRNmPMhGBcSV\",\"bucket\":\"if-bc\",\"fsize\":39335}\n```\n\n\n\n#### \u5e26\u56de\u8c03\u4e1a\u52a1\u670d\u52a1\u5668\u7684\u51ed\u8bc1\n\u4e0a\u9762\u751f\u6210\u7684`\u81ea\u5b9a\u4e49\u4e0a\u4f20\u56de\u590d`\u7684\u4e0a\u4f20\u51ed\u8bc1\u9002\u7528\u4e8e\u4e0a\u4f20\u7aef\uff08\u65e0\u8bba\u662f\u5ba2\u6237\u7aef\u8fd8\u662f\u670d\u52a1\u7aef\uff09\u548c\u79c1\u6709\u4e91\u5b58\u50a8\u670d\u52a1\u5668\u4e4b\u95f4\u8fdb\u884c\u76f4\u63a5\u4ea4\u4e92\u7684\u60c5\u51b5\u4e0b\u3002\u5728\u5ba2\u6237\u7aef\u4e0a\u4f20\u7684\u573a\u666f\u4e4b\u4e0b\uff0c\u6709\u65f6\u5019\u5ba2\u6237\u7aef\u9700\u8981\u5728\u6587\u4ef6\u4e0a\u4f20\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e4b\u540e\uff0c\u4ece\u4e1a\u52a1\u670d\u52a1\u5668\u83b7\u53d6\u76f8\u5173\u7684\u4fe1\u606f\uff0c\u8fd9\u4e2a\u65f6\u5019\u5c31\u8981\u7528\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u4e0a\u4f20\u56de\u8c03\u53ca\u76f8\u5173\u56de\u8c03\u53c2\u6570\u7684\u8bbe\u7f6e\u3002\n\n```\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nStringMap putPolicy = new StringMap();\nputPolicy.put(\"callbackUrl\", \"http:\/\/api.example.com\/qiniu\/upload\/callback\");\nputPolicy.put(\"callbackBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize)}\");\nputPolicy.put(\"callbackBodyType\", \"application\/json\");\nlong expireSeconds = 3600;\nString upToken = auth.uploadToken(bucket, null, expireSeconds, putPolicy);\nSystem.out.println(upToken);\n```\n\n\u5728\u4f7f\u7528\u4e86\u4e0a\u4f20\u56de\u8c03\u7684\u60c5\u51b5\u4e0b\uff0c\u5ba2\u6237\u7aef\u6536\u5230\u7684\u56de\u590d\u5c31\u662f\u4e1a\u52a1\u670d\u52a1\u5668\u54cd\u5e94\u79c1\u6709\u4e91\u5b58\u50a8\u7684JSON\u683c\u5f0f\u5185\u5bb9\u3002 \u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5efa\u8bae\u4f7f\u7528`application\/json`\u683c\u5f0f\u6765\u8bbe\u7f6e`callbackBody`\uff0c\u4fdd\u6301\u6570\u636e\u683c\u5f0f\u7684\u7edf\u4e00\u6027\u3002\u5b9e\u9645\u60c5\u51b5\u4e0b\uff0c`callbackBody`\u4e5f\u652f\u6301`application\/x-www-form-urlencoded`\u683c\u5f0f\u6765\u7ec4\u7ec7\u5185\u5bb9\uff0c\u8fd9\u4e2a\u4e3b\u8981\u770b\u4e1a\u52a1\u670d\u52a1\u5668\u5728\u63a5\u6536\u5230`callbackBody`\u7684\u5185\u5bb9\u65f6\u5982\u4f55\u89e3\u6790\u3002\u4f8b\u5982\uff1a\n\n```\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nStringMap putPolicy = new StringMap();\nputPolicy.put(\"callbackUrl\", \"http:\/\/api.example.com\/qiniu\/upload\/callback\");\nputPolicy.put(\"callbackBody\", \"key=$(key)&hash=$(etag)&bucket=$(bucket)&fsize=$(fsize)\");\nlong expireSeconds = 3600;\nString upToken = auth.uploadToken(bucket, null, expireSeconds, putPolicy);\nSystem.out.println(upToken);\n```\n\n\n\n#### \u5e26\u81ea\u5b9a\u4e49\u53c2\u6570\u7684\u51ed\u8bc1\n\n\u5b58\u50a8\u670d\u52a1\u652f\u6301\u5ba2\u6237\u7aef\u4e0a\u4f20\u6587\u4ef6\u7684\u65f6\u5019\u5b9a\u4e49\u4e00\u4e9b\u81ea\u5b9a\u4e49\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u53ef\u4ee5\u5728`returnBody`\u548c`callbackBody`\u91cc\u9762\u548c\u79c1\u6709\u4e91\u5b58\u50a8\u5185\u7f6e\u652f\u6301\u7684\u9b54\u6cd5\u53d8\u91cf\uff08\u5373\u7cfb\u7edf\u53d8\u91cf\uff09\u901a\u8fc7\u76f8\u540c\u7684\u65b9\u5f0f\u6765\u5f15\u7528\u3002\u8fd9\u4e9b\u81ea\u5b9a\u4e49\u7684\u53c2\u6570\u540d\u79f0\u5fc5\u987b\u4ee5`x:`\u5f00\u5934\u3002\u4f8b\u5982\u5ba2\u6237\u7aef\u4e0a\u4f20\u7684\u65f6\u5019\u6307\u5b9a\u4e86\u81ea\u5b9a\u4e49\u7684\u53c2\u6570`x:user`\u548c`x:age`\u5206\u522b\u662f`String`\u548c`int`\u7c7b\u578b\u3002\u90a3\u4e48\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u65b9\u5f0f\u5f15\u7528\uff1a\n\n```\nputPolicy.put(\"returnBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize),\\\"user\\\":\\\"$(x:user)\\\",\\\"age\\\",$(x:age)}\");\n```\n\n\u6216\u8005\n\n```\nputPolicy.put(\"callbackBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize),\\\"user\\\":\\\"$(x:user)\\\",\\\"age\\\",$(x:age)}\");\n```\n\n\n\n#### \u7efc\u5408\u4e0a\u4f20\u51ed\u8bc1\n\n\u4e0a\u9762\u7684\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\u7684\u65b9\u6cd5\uff0c\u90fd\u662f\u901a\u8fc7\u8bbe\u7f6e[\u4e0a\u4f20\u7b56\u7565\ud83d\udd17](https:\/\/portal.7oss-hk.cdncloud.com\/doc\/kodo\/manual\/1206\/put-policy.html)\u76f8\u5173\u7684\u53c2\u6570\u6765\u652f\u6301\u7684\uff0c\u8fd9\u4e9b\u53c2\u6570\u53ef\u4ee5\u901a\u8fc7\u4e0d\u540c\u7684\u7ec4\u5408\u65b9\u5f0f\u6765\u6ee1\u8db3\u4e0d\u540c\u7684\u4e1a\u52a1\u9700\u6c42\uff0c\u53ef\u4ee5\u7075\u6d3b\u5730\u7ec4\u7ec7\u4f60\u6240\u9700\u8981\u7684\u4e0a\u4f20\u51ed\u8bc1\u3002\n\n#### \u4e0a\u4f20\u51ed\u8bc1\u989d\u5916\u53c2\u6570\n\n\u9ed8\u8ba4\u4f1a\u62d2\u7edd\u4e0d\u5728\u9884\u5b9a\u4e49\u96c6\u4e2d\u7684\u53c2\u6570\u3002\u5373\uff1a\n\n```\nString upToken = auth.uploadToken(bucket, key, expireSeconds, putPolicy, true);\n```\n\n\u82e5\u5141\u8bb8\u6dfb\u52a0\u989d\u5916\u53c2\u6570\uff0c\u53ef\u4ee5\u5c06\u53c2\u6570\u8bbe\u7f6e\u4e3a`false`\u3002\n\n```\nString upToken = auth.uploadToken(bucket, key, expireSeconds, putPolicy, false);\n```\n\n\n\n### \u670d\u52a1\u7aef\u76f4\u4f20\n\n\u670d\u52a1\u7aef\u76f4\u4f20\u662f\u6307\u5ba2\u6237\u5229\u7528\u79c1\u6709\u4e91\u5b58\u50a8\u670d\u52a1\u7aefSDK\u4ece\u670d\u52a1\u7aef\u76f4\u63a5\u4e0a\u4f20\u6587\u4ef6\u5230\u79c1\u6709\u4e91\u5b58\u50a8\uff0c\u4ea4\u4e92\u7684\u53cc\u65b9\u4e00\u822c\u90fd\u5728\u673a\u623f\u91cc\u9762\uff0c\u6240\u4ee5\u670d\u52a1\u7aef\u53ef\u4ee5\u81ea\u5df1\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u5229\u7528SDK\u4e2d\u7684\u4e0a\u4f20\u903b\u8f91\u8fdb\u884c\u4e0a\u4f20\uff0c\u6700\u540e\u4ece\u79c1\u6709\u4e91\u5b58\u50a8\u83b7\u53d6\u4e0a\u4f20\u7684\u7ed3\u679c\uff0c\u8fd9\u4e2a\u8fc7\u7a0b\u4e2d\u7531\u4e8e\u53cc\u65b9\u90fd\u662f\u4e1a\u52a1\u670d\u52a1\u5668\uff0c\u6240\u4ee5\u5f88\u5c11\u5229\u7528\u5230\u4e0a\u4f20\u56de\u8c03\u7684\u529f\u80fd\uff0c\u800c\u662f\u76f4\u63a5\u81ea\u5b9a\u4e49`returnBody`\u6765\u83b7\u53d6\u81ea\u5b9a\u4e49\u7684\u56de\u590d\u5185\u5bb9\u3002\n\n\n\n#### \u6784\u5efa\u914d\u7f6e\u7c7b\n\n\u5b58\u50a8\u652f\u6301\u7a7a\u95f4\u521b\u5efa\u5728\u4e0d\u540c\u7684\u673a\u623f\uff0c\u5728\u4f7f\u7528Java SDK\u4e2d\u7684`UploadManager`\u4e0a\u4f20\u6587\u4ef6\u4e4b\u524d\uff0c\u5fc5\u987b\u8981\u6784\u5efa\u4e00\u4e2a\u4e0a\u4f20\u7528\u7684`Configuration`\u5bf9\u8c61\uff0c\u5728\u8be5\u5bf9\u8c61\u4e2d\uff0c\u53ef\u4ee5\u6307\u5b9a\u7a7a\u95f4\u5bf9\u5e94\u7684`Region`\u4ee5\u53ca\u5176\u4ed6\u7684\u4e00\u4e9b\u5f71\u54cd\u4e0a\u4f20\u7684\u53c2\u6570\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9aRegion\u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nUploadManager uploadManager = new UploadManager(cfg);\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\n```\n\n\u8de8\u533a\u57df\u53cc\u6d3b\u6307\u5b9a`RegionGroup`(\u5185\u6d4b\u529f\u80fd\uff0c\u9700\u8981\u5de5\u5355\u7533\u8bf7\u5f00\u901a\u8de8\u533a\u57df\u53cc\u6d3b\u529f\u80fd\u4e4b\u540e\u4f7f\u7528)\n\n```\nRegion region0 = Region.region0();\nRegion region1 = Region.region1();\nRegionGroup regionGroup = new RegionGroup();\nregionGroup.addRegion(region0);\nregionGroup.addRegion(region1);\nConfiguration config = new Configuration(regionGroup);\nconfig.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n```\n\n#### \u6ce8\u610f\n\n- \u82e5\u4e0d\u6307\u5b9a `Region` \u6216 `Region.autoRegion()` \uff0c\u5219\u4f1a\u4f7f\u7528 \u81ea\u52a8\u5224\u65ad \u533a\u57df\uff0c\u4f7f\u7528\u76f8\u5e94\u57df\u540d\u5904\u7406\u3002\n- \u5982\u679c\u53ef\u4ee5\u660e\u786e \u533a\u57df \u7684\u8bdd\uff0c\u6700\u597d\u6307\u5b9a\u56fa\u5b9a\u533a\u57df\uff0c\u8fd9\u6837\u53ef\u4ee5\u5c11\u4e00\u6b65\u7f51\u7edc\u8bf7\u6c42\uff0c\u5c11\u4e00\u6b65\u51fa\u9519\u7684\u53ef\u80fd\u3002\n\n\n\n#### \u81ea\u5b9a\u4e49\u533a\u57df\u57df\u540d\n\n```\nRegion region = new Region.Builder()\n .region(\"z0\")\n .accUpHost(\"up.qiniup.com\")\n .srcUpHost(\"upload.qiniup.com\")\n .iovipHost(\"iovip.qiniuio.com\")\n .rsHost(\"rs.qiniu.com\")\n .rsfHost(\"rsf.qiniu.com\")\n .apiHost(\"api.qiniu.com\")\n .build();\nConfiguration cfg = new Configuration(region);\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n```\n\n\n\n#### \u8bbe\u7f6e\u8bf7\u6c42\u534f\u8bae\u4e3ahttp\n\n```\nConfiguration cfg = new Configuration(zone);\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\ncfg.useHttpsDomains = false;\nUploadManager uploadManager = new UploadManager(cfg);\n```\n\n\n\n#### \u6587\u4ef6\u4e0a\u4f20\n\n\u6700\u7b80\u5355\u7684\u5c31\u662f\u4e0a\u4f20\u672c\u5730\u6587\u4ef6\uff0c\u76f4\u63a5\u6307\u5b9a\u6587\u4ef6\u7684\u5b8c\u6574\u8def\u5f84\u5373\u53ef\u4e0a\u4f20\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nUploadManager uploadManager = new UploadManager(cfg);\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\n\/\/\u5982\u679c\u662fWindows\u60c5\u51b5\u4e0b\uff0c\u683c\u5f0f\u662f D:\\\\qiniu\\\\test.png\nString localFilePath = \"\/home\/qiniu\/test.png\";\n\/\/\u9ed8\u8ba4\u4e0d\u6307\u5b9akey\u7684\u60c5\u51b5\u4e0b\uff0c\u4ee5\u6587\u4ef6\u5185\u5bb9\u7684hash\u503c\u4f5c\u4e3a\u6587\u4ef6\u540d\nString key = null;\n\nAuth auth = Auth.create(accessKey, secretKey);\nString upToken = auth.uploadToken(bucket);\n\ntry {\n Response response = uploadManager.put(localFilePath, key, upToken);\n \/\/\u89e3\u6790\u4e0a\u4f20\u6210\u529f\u7684\u7ed3\u679c\n DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);\n System.out.println(putRet.key);\n System.out.println(putRet.hash);\n} catch (QiniuException ex) {\n Response r = ex.response;\n System.err.println(r.toString());\n try {\n System.err.println(r.bodyString());\n } catch (QiniuException ex2) {\n \/\/ignore\n }\n}\n```\n\n\n\n#### \u5b57\u8282\u6570\u7ec4\u4e0a\u4f20\n\n\u53ef\u4ee5\u652f\u6301\u5c06\u5185\u5b58\u4e2d\u7684\u5b57\u8282\u6570\u7ec4\u4e0a\u4f20\u5230\u7a7a\u95f4\u4e2d\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nUploadManager uploadManager = new UploadManager(cfg);\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\n\n\/\/\u9ed8\u8ba4\u4e0d\u6307\u5b9akey\u7684\u60c5\u51b5\u4e0b\uff0c\u4ee5\u6587\u4ef6\u5185\u5bb9\u7684hash\u503c\u4f5c\u4e3a\u6587\u4ef6\u540d\nString key = null;\n\ntry {\n byte[] uploadBytes = \"hello qiniu cloud\".getBytes(\"utf-8\");\n Auth auth = Auth.create(accessKey, secretKey);\n String upToken = auth.uploadToken(bucket);\n\n try {\n Response response = uploadManager.put(uploadBytes, key, upToken);\n \/\/\u89e3\u6790\u4e0a\u4f20\u6210\u529f\u7684\u7ed3\u679c\n DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);\n System.out.println(putRet.key);\n System.out.println(putRet.hash);\n } catch (QiniuException ex) {\n Response r = ex.response;\n System.err.println(r.toString());\n try {\n System.err.println(r.bodyString());\n } catch (QiniuException ex2) {\n \/\/ignore\n }\n }\n} catch (UnsupportedEncodingException ex) {\n \/\/ignore\n}\n```\n\n\n\n#### \u6570\u636e\u6d41\u4e0a\u4f20\n\n\u8fd9\u91cc\u6f14\u793a\u7684\u662f`InputStream`\u5bf9\u8c61\u7684\u4e0a\u4f20\uff0c\u9002\u7528\u4e8e\u6240\u6709\u7684`InputStream`\u5b50\u7c7b\u3002\u8fd9\u91cc\u7684`ByteInputStream`\u53ea\u7528\u4e8e\u6f14\u793a\u76ee\u7684\uff0c\u5b9e\u9645\u7528\u6cd5\u6839\u636e\u60c5\u51b5\u800c\u5b9a\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nUploadManager uploadManager = new UploadManager(cfg);\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\n\n\/\/\u9ed8\u8ba4\u4e0d\u6307\u5b9akey\u7684\u60c5\u51b5\u4e0b\uff0c\u4ee5\u6587\u4ef6\u5185\u5bb9\u7684hash\u503c\u4f5c\u4e3a\u6587\u4ef6\u540d\nString key = null;\n\ntry {\n byte[] uploadBytes = \"hello qiniu cloud\".getBytes(\"utf-8\");\n ByteArrayInputStream byteInputStream=new ByteArrayInputStream(uploadBytes);\n Auth auth = Auth.create(accessKey, secretKey);\n String upToken = auth.uploadToken(bucket);\n\n try {\n Response response = uploadManager.put(byteInputStream,key,upToken,null, null);\n \/\/\u89e3\u6790\u4e0a\u4f20\u6210\u529f\u7684\u7ed3\u679c\n DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);\n System.out.println(putRet.key);\n System.out.println(putRet.hash);\n } catch (QiniuException ex) {\n Response r = ex.response;\n System.err.println(r.toString());\n try {\n System.err.println(r.bodyString());\n } catch (QiniuException ex2) {\n \/\/ignore\n }\n }\n} catch (UnsupportedEncodingException ex) {\n \/\/ignore\n}\n```\n\n\n\n#### \u65ad\u70b9\u7eed\u4e0a\u4f20\n\n\u65ad\u70b9\u7eed\u4f20\u662f\u5728\u5206\u7247\u4e0a\u4f20\u7684\u57fa\u7840\u4e0a\u5b9e\u73b0\u3002SDK \u5185\u7f6e\u4e24\u79cd\u4e0a\u4f20\u65b9\u5f0f\uff1a\u8868\u5355\u4e0a\u4f20\u548c\u5206\u7247\u4e0a\u4f20\u3002\u8868\u5355\u4e0a\u4f20\u4f7f\u7528\u4e00\u4e2a HTTP POST \u8bf7\u6c42\u5b8c\u6210\u6587\u4ef6\u7684\u4e0a\u4f20\uff0c\u56e0\u6b64\u6bd4\u8f83\u9002\u5408\u8f83\u5c0f\u7684\u6587\u4ef6\u3002\u76f8\u6bd4\u800c\u8a00\uff0c\u5206\u7247\u4e0a\u4f20\u6bd4\u8f83\u9002\u5408\u4e0a\u4f20\u6bd4\u8f83\u5927\u7684\u6587\u4ef6\uff08\u4f8b\u5982\u6570\u767e MB \u6216\u66f4\u5927\uff09\u3002 \u82e5\u9700\u6df1\u5165\u4e86\u89e3\u4e0a\u4f20\u65b9\u5f0f\u4e4b\u95f4\u7684\u533a\u522b\uff0c\u8bf7\u53c2\u9605\u4e0a\u4f20\u7c7b\u578b\u4e2d \u8868\u5355\u4e0a\u4f20\u3001\u5206\u7247\u4e0a\u4f20 v1 \u7248 \u548c \u5206\u7247\u4e0a\u4f20 v2 \u7248\u63a5\u53e3\u8bf4\u660e\u3002 \u53ef\u4ee5\u9009\u62e9\u5206\u7247\u4e0a\u4f20\u7248\u672c\uff0c\u63a8\u8350 Configuration.ResumableUploadAPIVersion.V2\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v2 \u7248\uff0c\u9ed8\u8ba4 Configuration.ResumableUploadAPIVersion.V1\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v1 \u7248\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\ncfg.resumableUploadMaxConcurrentTaskCount = 2; \/\/ \u8bbe\u7f6e\u5206\u7247\u4e0a\u4f20\u5e76\u53d1\uff0c1\uff1a\u91c7\u7528\u540c\u6b65\u4e0a\u4f20\uff1b\u5927\u4e8e1\uff1a\u91c7\u7528\u5e76\u53d1\u4e0a\u4f20\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\n\/\/\u5982\u679c\u662fWindows\u60c5\u51b5\u4e0b\uff0c\u683c\u5f0f\u662f D:\\\\qiniu\\\\test.png\nString localFilePath = \"\/home\/qiniu\/test.mp4\";\n\/\/\u9ed8\u8ba4\u4e0d\u6307\u5b9akey\u7684\u60c5\u51b5\u4e0b\uff0c\u4ee5\u6587\u4ef6\u5185\u5bb9\u7684hash\u503c\u4f5c\u4e3a\u6587\u4ef6\u540d\nString key = null;\n\nAuth auth = Auth.create(accessKey, secretKey);\nString upToken = auth.uploadToken(bucket);\n\nString localTempDir = Paths.get(System.getenv(\"java.io.tmpdir\"), bucket).toString();\ntry {\n \/\/\u8bbe\u7f6e\u65ad\u70b9\u7eed\u4f20\u6587\u4ef6\u8fdb\u5ea6\u4fdd\u5b58\u76ee\u5f55\n FileRecorder fileRecorder = new FileRecorder(localTempDir);\n UploadManager uploadManager = new UploadManager(cfg, fileRecorder);\n try {\n Response response = uploadManager.put(localFilePath, key, upToken);\n \/\/\u89e3\u6790\u4e0a\u4f20\u6210\u529f\u7684\u7ed3\u679c\n DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class);\n System.out.println(putRet.key);\n System.out.println(putRet.hash);\n } catch (QiniuException ex) {\n Response r = ex.response;\n System.err.println(r.toString());\n try {\n System.err.println(r.bodyString());\n } catch (QiniuException ex2) {\n \/\/ignore\n }\n }\n} catch (IOException ex) {\n ex.printStackTrace();\n}\n```\n\n\n\n#### \u81ea\u5b9a\u4e49\u53c2\u6570\u4e0a\u4f20\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\ncfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;\/\/ \u6307\u5b9a\u5206\u7247\u4e0a\u4f20\u7248\u672c\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\n\/\/...\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u51c6\u5907\u4e0a\u4f20\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\n\/\/\u5982\u679c\u662fWindows\u60c5\u51b5\u4e0b\uff0c\u683c\u5f0f\u662f D:\\\\qiniu\\\\test.png\nString localFilePath = \"\/home\/qiniu\/test.mp4\";\n\/\/\u9ed8\u8ba4\u4e0d\u6307\u5b9akey\u7684\u60c5\u51b5\u4e0b\uff0c\u4ee5\u6587\u4ef6\u5185\u5bb9\u7684hash\u503c\u4f5c\u4e3a\u6587\u4ef6\u540d\n\/\/\u8bbe\u7f6e\u4e0a\u4f20\u540e\u7684\u6587\u4ef6\u540d\u79f0\nString key = \"qiniu_test.jpg\";\n\nAuth auth = Auth.create(accessKey, secretKey);\n\n\/\/\u4e0a\u4f20\u81ea\u5b9a\u4e49\u53c2\u6570\uff0c\u81ea\u5b9a\u4e49\u53c2\u6570\u540d\u79f0\u9700\u8981\u4ee5 x:\u5f00\u5934\nStringMap params = new StringMap();\nparams.put(\"x:fname\",\"123.jpg\");\nparams.put(\"x:age\",20);\n\n\/\/\u4e0a\u4f20\u7b56\u7565\nStringMap policy = new StringMap();\n\/\/\u81ea\u5b9a\u4e49\u4e0a\u4f20\u540e\u8fd4\u56de\u5185\u5bb9\uff0c\u8fd4\u56de\u81ea\u5b9a\u4e49\u53c2\u6570\uff0c\u9700\u8981\u8bbe\u7f6e x:\u53c2\u6570\u540d\u79f0\uff0c\u6ce8\u610f\u4e0b\u9762\npolicy.put(\"returnBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"fname\\\":\\\"$(x:fname)\\\",\\\"age\\\",$(x:age)}\");\n\/\/\u751f\u6210\u4e0a\u4f20token\nString upToken = auth.uploadToken(bucket, key, 3600, policy);\ntry {\n Response response = uploadManager.put(localFilePath, key, upToken,params,null,false);\n System.out.println(response.bodyString());\n} catch (QiniuException ex) {\n Response r = ex.response;\n System.err.println(r.toString());\n try {\n System.err.println(r.bodyString());\n } catch (QiniuException ex2) {\n \/\/ignore\n }\n}\n```\n\n\n\n### \u89e3\u6790\u81ea\u5b9a\u4e49\u56de\u590d\u5185\u5bb9\n\n\u6709\u4e9b\u60c5\u51b5\u4e0b\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u8fd4\u56de\u7ed9\u4e0a\u4f20\u7aef\u7684\u5185\u5bb9\u4e0d\u662f\u9ed8\u8ba4\u7684`hash`\u548c`key`\u5f62\u5f0f\uff0c\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u80fd\u51fa\u73b0\u5728\u81ea\u5b9a\u4e49`returnBody`\u6216\u8005\u81ea\u5b9a\u4e49\u4e86`callbackBody`\u7684\u60c5\u51b5\u4e0b\uff0c\u524d\u8005\u4e00\u822c\u662f\u670d\u52a1\u7aef\u76f4\u4f20\u7684\u573a\u666f\uff0c\u800c\u540e\u8005\u5219\u662f\u63a5\u53d7\u4e0a\u4f20\u56de\u8c03\u7684\u573a\u666f\uff0c\u8fd9\u4e24\u79cd\u573a\u666f\u4e4b\u4e0b\uff0c\u90fd\u6d89\u53ca\u5230\u9700\u8981\u5c06\u81ea\u5b9a\u4e49\u7684\u56de\u590d\u5185\u5bb9\u89e3\u6790\u4e3a`Java`\u7684\u7c7b\u5bf9\u8c61\uff0c\u4e00\u822c\u5efa\u8bae\u5728\u4ea4\u4e92\u8fc7\u7a0b\u4e2d\uff0c\u90fd\u91c7\u7528`JSON`\u7684\u65b9\u5f0f\uff0c\u8fd9\u6837\u5904\u7406\u8d77\u6765\u65b9\u6cd5\u6bd4\u8f83\u4e00\u81f4\uff0c\u800c\u4e14`JSON`\u7684\u65b9\u6cd5\u6700\u901a\u7528\u3002\n\n\u9047\u5230\u8bf8\u5982\u81ea\u5b9a\u4e49`returnBody`\u7684\u60c5\u51b5\uff1a\n\n```\nputPolicy.put(\"returnBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize)}\");\n```\n\n\u6216\u8005\u662f\u81ea\u5b9a\u4e49\u4e86`callbackBody`\u7684\u60c5\u51b5\uff1a\n\n```\nputPolicy.put(\"callbackBody\", \"{\\\"key\\\":\\\"$(key)\\\",\\\"hash\\\":\\\"$(etag)\\\",\\\"bucket\\\":\\\"$(bucket)\\\",\\\"fsize\\\":$(fsize)}\");\n```\n\n\u6211\u4eec\u53ea\u9700\u8981\u81ea\u5df1\u5b9a\u4e49\u4e86\u5bf9\u5e94\u7684\u7c7b\uff0c\u4f8b\u5982\uff1a\n\n```\nclass MyPutRet {\n public String key;\n public String hash;\n public String bucket;\n public long fsize;\n}\n```\n\n\u7136\u540e\u5728\u83b7\u53d6\u5230\u4e0a\u4f20\u56de\u590d\u7684`Response`\u5bf9\u8c61\u65f6\uff0c\u4f7f\u7528\u5982\u4e0b\u7684\u65b9\u6cd5\u5c31\u53ef\u4ee5\u8f6c\u4e3a\u81ea\u5b9a\u4e49\u56de\u590d\u7684\u7c7b\u5bf9\u8c61\u4e86\uff1a\n\n```\nMyPutRet myPutRet=response.jsonToObject(MyPutRet.class);\n```\n\n\n\n### \u4e1a\u52a1\u670d\u52a1\u5668\u9a8c\u8bc1\u5b58\u50a8\u670d\u52a1\u56de\u8c03\n\n\u5728\u4e0a\u4f20\u7b56\u7565\u91cc\u9762\u8bbe\u7f6e\u4e86\u4e0a\u4f20\u56de\u8c03\u76f8\u5173\u53c2\u6570\u7684\u65f6\u5019\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u5728\u6587\u4ef6\u4e0a\u4f20\u5230\u670d\u52a1\u5668\u4e4b\u540e\uff0c\u4f1a\u4e3b\u52a8\u5730\u5411`callbackUrl`\u53d1\u9001POST\u8bf7\u6c42\u7684\u56de\u8c03\uff0c\u56de\u8c03\u7684\u5185\u5bb9\u4e3a`callbackBody`\u6a21\u7248\u6240\u5b9a\u4e49\u7684\u5185\u5bb9\uff0c\u5982\u679c\u8fd9\u4e2a\u6a21\u7248\u91cc\u9762\u5f15\u7528\u4e86\u9b54\u6cd5\u53d8\u91cf\u6216\u8005\u81ea\u5b9a\u4e49\u53d8\u91cf\uff0c\u90a3\u4e48\u8fd9\u4e9b\u53d8\u91cf\u4f1a\u88ab\u81ea\u52a8\u586b\u5145\u5bf9\u5e94\u7684\u503c\uff0c\u7136\u540e\u5728\u53d1\u9001\u7ed9\u4e1a\u52a1\u670d\u52a1\u5668\u3002\n\n\u4e1a\u52a1\u670d\u52a1\u5668\u5728\u6536\u5230\u6765\u81ea\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u56de\u8c03\u8bf7\u6c42\u7684\u65f6\u5019\uff0c\u53ef\u4ee5\u6839\u636e\u8bf7\u6c42\u5934\u90e8\u7684`Authorization`\u5b57\u6bb5\u6765\u8fdb\u884c\u9a8c\u8bc1\uff0c\u67e5\u770b\u8be5\u8bf7\u6c42\u662f\u5426\u662f\u6765\u81ea\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u672a\u7ecf\u7be1\u6539\u7684\u8bf7\u6c42\u3002\u5177\u4f53\u53ef\u4ee5\u53c2\u8003\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u56de\u8c03\u9274\u6743\u3002\n\n\u6ce8\u610f\uff1a\u4e1a\u52a1\u7aef\u670d\u52a1\u5668\u56de\u8c03\u9274\u6743\u7684Content-Type\u7c7b\u578b\u5e94\u8be5\u4e0e\u4e0a\u4f20\u7b56\u7565\u4e2d\u6307\u5b9a\u7684callbackBodyType\u76f8\u540c\uff0c\u9ed8\u8ba4\u4e3a application\/x-www-form-urlencoded\uff0c\u5f53 Content-Type \u4e3a application\/x-www-form-urlencoded \u65f6\uff0c\u7b7e\u540d\u5185\u5bb9\u5fc5\u987b\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9\u3002\u5f53 Content-Type \u4e3a application\/json \u65f6\uff0c\u7b7e\u540d\u5185\u5bb9\u4e0d\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9\u3002\n\n```\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\n\/*\n* \u8fd9\u4e24\u4e2a\u53c2\u6570\u5c31\u662f\u5728\u5b9a\u4e49PutPolicy\u53c2\u6570\u65f6\u6307\u5b9a\u7684\u5185\u5bb9\n*\/\n\n\/\/\u56de\u8c03\u5730\u5740\nString callbackUrl = \"http:\/\/api.example.com\/qiniu\/callback\";\n\/\/\u5b9a\u4e49\u56de\u8c03\u5185\u5bb9\u7684\u7ec4\u7ec7\u683c\u5f0f\uff0c\u4e0e\u4e0a\u4f20\u7b56\u7565\u4e2d\u7684callbackBodyType\u8981\u4fdd\u6301\u4e00\u81f4\n\/\/String callbackBodyType = \"application\/x-www-form-urlencoded\"; \/\/\u56de\u8c03\u9274\u6743\u7684\u7b7e\u540d\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9callbackBody\nString callbackBodyType = \"application\/json\";\/\/\u56de\u8c03\u9274\u6743\u7684\u7b7e\u540d\u4e0d\u5305\u62ec\u8bf7\u6c42\u5185\u5bb9\n\n\/**\n * \u8fd9\u4e24\u4e2a\u53c2\u6570\u6839\u636e\u5b9e\u9645\u6240\u4f7f\u7528\u7684HTTP\u6846\u67b6\u8fdb\u884c\u83b7\u53d6\n *\/\n\/\/\u901a\u8fc7\u83b7\u53d6\u8bf7\u6c42\u7684HTTP\u5934\u90e8Authorization\u5b57\u6bb5\u83b7\u5f97\nString callbackAuthHeader = \"xxx\";\n\/\/\u901a\u8fc7\u8bfb\u53d6\u56de\u8c03POST\u8bf7\u6c42\u4f53\u83b7\u5f97\uff0c\u4e0d\u8981\u8bbe\u7f6e\u4e3anull\nbyte[] callbackBody = null;\n\n\nAuth auth = Auth.create(accessKey, secretKey);\n\/\/\u68c0\u67e5\u662f\u5426\u4e3a\u5408\u6cd5\u7684\u56de\u8c03\u8bf7\u6c42\nboolean validCallback = auth.isValidCallback(callbackAuthHeader, callbackUrl, callbackBody, callbackBodyType);\nif (validCallback) {\n \/\/\u7ee7\u7eed\u5904\u7406\u5176\u4ed6\u4e1a\u52a1\u903b\u8f91\n} else {\n \/\/\u8fd9\u662f\u54ea\u91cc\u7684\u8bf7\u6c42\uff0c\u88ab\u52ab\u6301\uff0c\u7be1\u6539\u4e86\u5427\uff1f\n}\n```\n\n\n\n# \u4e0b\u8f7d\u6587\u4ef6\n\n\u6587\u4ef6\u4e0b\u8f7d\u5206\u4e3a\u516c\u5f00\u7a7a\u95f4\u7684\u6587\u4ef6\u4e0b\u8f7d\u548c\u79c1\u6709\u7a7a\u95f4\u7684\u6587\u4ef6\u4e0b\u8f7d\u3002\n\n\n\n### \u516c\u5f00\u7a7a\u95f4\n\n#### \u624b\u52a8\u62fc\u63a5\u65b9\u5f0f\n\n\u5bf9\u4e8e\u516c\u5f00\u7a7a\u95f4\uff0c\u5176\u8bbf\u95ee\u7684\u94fe\u63a5\u4e3b\u8981\u662f\u5c06\u7a7a\u95f4\u7ed1\u5b9a\u7684\u57df\u540d\u62fc\u63a5\u4e0a\u7a7a\u95f4\u91cc\u9762\u7684\u6587\u4ef6\u540d\u5373\u53ef\u8bbf\u95ee\uff0c\u6807\u51c6\u60c5\u51b5\u4e0b\u9700\u8981\u5728\u62fc\u63a5\u94fe\u63a5\u4e4b\u524d\uff0c\u5c06\u6587\u4ef6\u540d\u8fdb\u884c`urlencode`\u4ee5\u517c\u5bb9\u4e0d\u540c\u7684\u5b57\u7b26\u3002\u5982\u679c\u6709\u5176\u4ed6\u8bbf\u95ee\u5904\u7406\u9700\u6c42\uff0c\u5728\u6587\u4ef6\u540d\u4e4b\u540e\u7ee7\u7eed\u62fc\u63a5\u5373\u53ef\u3002\n\n```\nString fileName = \"\u516c\u53f8\/\u5b58\u50a8\/qiniu.jpg\";\nString domainOfBucket = \"http:\/\/devtools.qiniu.com\";\nString encodedFileName = URLEncoder.encode(fileName, \"utf-8\").replace(\"+\", \"%20\");\nString finalUrl = String.format(\"%s\/%s\", domainOfBucket, encodedFileName);\nSystem.out.println(finalUrl);\n```\n\n#### sdk \u81ea\u52a8\u751f\u6210\u65b9\u5f0f\n\nsdk \u5c01\u88c5\u4e86\u4e0b\u8f7d URL \u7684\u751f\u6210\uff0c\u53ea\u9700\u8981\u8f93\u5165\u4e0b\u8f7d\u6240\u9700\u53c2\u6570\u5373\u53ef\u3002\u5df2\u652f\u6301\u591a\u5a92\u4f53\u5904\u7406\u547d\u4ee4\u7b49\u3002\n\n```\n\/\/ domain \u4e0b\u8f7d domain, eg: qiniu.com\u3010\u5fc5\u987b\u3011\n\/\/ useHttps \u662f\u5426\u4f7f\u7528 https\u3010\u5fc5\u987b\u3011\n\/\/ key \u4e0b\u8f7d\u8d44\u6e90\u5728\u4e03\u725b\u4e91\u5b58\u50a8\u7684 key\u3010\u5fc5\u987b\u3011\nDownloadUrl url = new DownloadUrl(domain, useHttps, key);\nurl.setAttname(attname) \/\/ \u914d\u7f6e attname\n .setFop(fop) \/\/ \u914d\u7f6e fop\n .setStyle(style, styleSeparator, styleParam) \/\/ \u914d\u7f6e style\nString urlString = url.buildURL();\nSystem.out.println(urlString);\n```\n\n\n\n### \u79c1\u6709\u7a7a\u95f4\n\n#### \u624b\u52a8\u62fc\u63a5\u65b9\u5f0f\n\n\u5bf9\u4e8e\u79c1\u6709\u7a7a\u95f4\uff0c\u9996\u5148\u9700\u8981\u6309\u7167\u516c\u5f00\u7a7a\u95f4\u7684\u6587\u4ef6\u8bbf\u95ee\u65b9\u5f0f\u6784\u5efa\u5bf9\u5e94\u7684\u516c\u5f00\u7a7a\u95f4\u8bbf\u95ee\u94fe\u63a5\uff0c\u7136\u540e\u518d\u5bf9\u8fd9\u4e2a\u94fe\u63a5\u8fdb\u884c\u79c1\u6709\u6388\u6743\u7b7e\u540d\u3002\n\n```\nString fileName = \"\u516c\u53f8\/\u5b58\u50a8\/qiniu.jpg\";\nString domainOfBucket = \"http:\/\/devtools.qiniu.com\";\nString encodedFileName = URLEncoder.encode(fileName, \"utf-8\").replace(\"+\", \"%20\");\nString publicUrl = String.format(\"%s\/%s\", domainOfBucket, encodedFileName);\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nAuth auth = Auth.create(accessKey, secretKey);\nlong expireInSeconds = 3600;\/\/1\u5c0f\u65f6\uff0c\u53ef\u4ee5\u81ea\u5b9a\u4e49\u94fe\u63a5\u8fc7\u671f\u65f6\u95f4\nString finalUrl = auth.privateDownloadUrl(publicUrl, expireInSeconds);\nSystem.out.println(finalUrl);\n```\n\n#### sdk \u81ea\u52a8\u751f\u6210\u65b9\u5f0f\n\nsdk \u5c01\u88c5\u4e86\u4e0b\u8f7d URL \u7684\u751f\u6210\uff0c\u53ea\u9700\u8981\u8f93\u5165\u4e0b\u8f7d\u6240\u9700\u53c2\u6570\u5373\u53ef\u3002\u5df2\u652f\u6301\u591a\u5a92\u4f53\u5904\u7406\u547d\u4ee4\uff0c\u8fc7\u671f\u65f6\u95f4 e \u548c \u7b7e\u540d token \u7b49\u3002\n\n```\n\/\/ domain \u4e0b\u8f7d domain, eg: qiniu.com\u3010\u5fc5\u987b\u3011\n\/\/ useHttps \u662f\u5426\u4f7f\u7528 https\u3010\u5fc5\u987b\u3011\n\/\/ key \u4e0b\u8f7d\u8d44\u6e90\u5728\u4e03\u725b\u4e91\u5b58\u50a8\u7684 key\u3010\u5fc5\u987b\u3011\nDownloadUrl url = new DownloadUrl(domain, useHttps, key);\nurl.setAttname(attname) \/\/ \u914d\u7f6e attname\n .setFop(fop) \/\/ \u914d\u7f6e fop\n .setStyle(style, styleSeparator, styleParam) \/\/ \u914d\u7f6e style\n \/\/ \u5e26\u6709\u6548\u671f\nlong expireInSeconds = 3600;\/\/1\u5c0f\u65f6\uff0c\u53ef\u4ee5\u81ea\u5b9a\u4e49\u94fe\u63a5\u8fc7\u671f\u65f6\u95f4\nAuth auth = Auth.create(\"your access key\", \"your secret key\");\nString urlString = url.buildURL(auth, deadline);\nSystem.out.println(urlString);\n```\n\n\n\n# \u8d44\u6e90\u7ba1\u7406\n\n\n\n## \u83b7\u53d6\u6587\u4ef6\u4fe1\u606f\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\nString bucket = \"your bucket name\";\nString key = \"your file key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n FileInfo fileInfo = bucketManager.stat(bucket, key);\n System.out.println(fileInfo.hash);\n System.out.println(fileInfo.fsize);\n System.out.println(fileInfo.mimeType);\n System.out.println(fileInfo.putTime);\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u4fee\u6539\u6587\u4ef6\u7c7b\u578b\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\nString key = \"your file key\";\nString newMimeType = \"new mime type\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\n\/\/\u4fee\u6539\u6587\u4ef6\u7c7b\u578b\ntry {\n bucketManager.changeMime(bucket, key, newMimeType);\n} catch (QiniuException ex) {\n System.out.println(ex.response.toString());\n}\n```\n\n\n\n## \u79fb\u52a8\u6216\u91cd\u547d\u540d\u6587\u4ef6\n\n\u79fb\u52a8\u64cd\u4f5c\u672c\u8eab\u652f\u6301\u79fb\u52a8\u6587\u4ef6\u5230\u76f8\u540c\uff0c\u4e0d\u540c\u7a7a\u95f4\u4e2d\uff0c\u5728\u79fb\u52a8\u7684\u540c\u65f6\u4e5f\u53ef\u4ee5\u652f\u6301\u6587\u4ef6\u91cd\u547d\u540d\u3002\u552f\u4e00\u7684\u9650\u5236\u6761\u4ef6\u662f\uff0c\u79fb\u52a8\u7684\u6e90\u7a7a\u95f4\u548c\u76ee\u6807\u7a7a\u95f4\u5fc5\u987b\u5728\u540c\u4e00\u4e2a\u673a\u623f\u3002\n\n| \u6e90\u7a7a\u95f4 | \u76ee\u6807\u7a7a\u95f4 | \u6e90\u6587\u4ef6\u540d | \u76ee\u6807\u6587\u4ef6\u540d | \u63cf\u8ff0 |\n| ------- | -------- | -------- | ---------- | --------------------------------- |\n| BucketA | BucketA | KeyA | KeyB | \u76f8\u5f53\u4e8e\u540c\u7a7a\u95f4\u6587\u4ef6\u91cd\u547d\u540d |\n| BucketA | BucketB | KeyA | KeyA | \u79fb\u52a8\u6587\u4ef6\u5230BucketB\uff0c\u6587\u4ef6\u540d\u4e00\u81f4 |\n| BucketA | BucketB | KeyA | KeyB | \u79fb\u52a8\u6587\u4ef6\u5230BucketB\uff0c\u6587\u4ef6\u540d\u53d8\u6210KeyB |\n\n`move`\u64cd\u4f5c\u652f\u6301\u5f3a\u5236\u8986\u76d6\u9009\u9879\uff0c\u5373\u5982\u679c\u76ee\u6807\u6587\u4ef6\u5df2\u5b58\u5728\uff0c\u53ef\u4ee5\u8bbe\u7f6e\u5f3a\u5236\u8986\u76d6\u53c2\u6570`force`\u6765\u8986\u76d6\u90a3\u4e2a\u6587\u4ef6\u7684\u5185\u5bb9\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString fromBucket = \"from bucket name\";\nString fromKey = \"from key\";\nString toBucket = \"to bucket name\";\nString toKey = \"to key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n bucketManager.move(fromBucket, fromKey, toBucket, toKey);\n} catch (QiniuException ex) {\n \/\/\u5982\u679c\u9047\u5230\u5f02\u5e38\uff0c\u8bf4\u660e\u79fb\u52a8\u5931\u8d25\n System.err.println(ex.code());\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u590d\u5236\u6587\u4ef6\u526f\u672c\n\n\u6587\u4ef6\u7684\u590d\u5236\u548c\u6587\u4ef6\u79fb\u52a8\u5176\u5b9e\u64cd\u4f5c\u4e00\u6837\uff0c\u4e3b\u8981\u7684\u533a\u522b\u662f\u79fb\u52a8\u540e\u6e90\u6587\u4ef6\u4e0d\u5b58\u5728\u4e86\uff0c\u800c\u590d\u5236\u7684\u7ed3\u679c\u662f\u6e90\u6587\u4ef6\u8fd8\u5b58\u5728\uff0c\u53ea\u662f\u591a\u4e86\u4e00\u4e2a\u65b0\u7684\u6587\u4ef6\u526f\u672c\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString fromBucket = \"from bucket name\";\nString fromKey = \"from key\";\nString toBucket = \"to bucket name\";\nString toKey = \"to key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n bucketManager.copy(fromBucket, fromKey, toBucket, toKey);\n} catch (QiniuException ex) {\n \/\/\u5982\u679c\u9047\u5230\u5f02\u5e38\uff0c\u8bf4\u660e\u590d\u5236\u5931\u8d25\n System.err.println(ex.code());\n System.err\n}\n```\n\n\n\n## \u5220\u9664\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\nString key = \"your file key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n bucketManager.delete(bucket, key);\n} catch (QiniuException ex) {\n \/\/\u5982\u679c\u9047\u5230\u5f02\u5e38\uff0c\u8bf4\u660e\u5220\u9664\u5931\u8d25\n System.err.println(ex.code());\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u8bbe\u7f6e\u6216\u66f4\u65b0\u6587\u4ef6\u7684\u751f\u5b58\u65f6\u95f4\n\n\u53ef\u4ee5\u7ed9\u5df2\u7ecf\u5b58\u5728\u4e8e\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\u8bbe\u7f6e\u6587\u4ef6\u751f\u5b58\u65f6\u95f4\uff0c\u6216\u8005\u66f4\u65b0\u5df2\u8bbe\u7f6e\u4e86\u751f\u5b58\u65f6\u95f4\u4f46\u5c1a\u672a\u88ab\u5220\u9664\u7684\u6587\u4ef6\u7684\u65b0\u7684\u751f\u5b58\u65f6\u95f4\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"access key\";\nString secretKey = \"secret key\";\nString bucket = \"bucket name\";\nString key = \"file key\";\n\/\/\u8fc7\u671f\u5929\u6570\uff0c\u8be5\u6587\u4ef610\u5929\u540e\u5220\u9664\nint days = 10;\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n bucketManager.deleteAfterDays(bucket, key, days);\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u83b7\u53d6\u7a7a\u95f4\u6587\u4ef6\u5217\u8868\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\n\/\/\u6587\u4ef6\u540d\u524d\u7f00\nString prefix = \"\";\n\/\/\u6bcf\u6b21\u8fed\u4ee3\u7684\u957f\u5ea6\u9650\u5236\uff0c\u6700\u59271000\uff0c\u63a8\u8350\u503c 1000\nint limit = 1000;\n\/\/\u6307\u5b9a\u76ee\u5f55\u5206\u9694\u7b26\uff0c\u5217\u51fa\u6240\u6709\u516c\u5171\u524d\u7f00\uff08\u6a21\u62df\u5217\u51fa\u76ee\u5f55\u6548\u679c\uff09\u3002\u7f3a\u7701\u503c\u4e3a\u7a7a\u5b57\u7b26\u4e32\nString delimiter = \"\";\n\n\/\/\u5217\u4e3e\u7a7a\u95f4\u6587\u4ef6\u5217\u8868\nBucketManager.FileListIterator fileListIterator = bucketManager.createFileListIterator(bucket, prefix, limit, delimiter);\nwhile (fileListIterator.hasNext()) {\n \/\/\u5904\u7406\u83b7\u53d6\u7684file list\u7ed3\u679c\n FileInfo[] items = fileListIterator.next();\n for (FileInfo item : items) {\n System.out.println(item.key);\n System.out.println(item.hash);\n System.out.println(item.fsize);\n System.out.println(item.mimeType);\n System.out.println(item.putTime);\n System.out.println(item.endUser);\n }\n}\n```\n\n\n\n## \u6293\u53d6\u7f51\u7edc\u8d44\u6e90\u5230\u7a7a\u95f4\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\nString key = \"your file key\";\nString remoteSrcUrl = \"http:\/\/devtools.qiniu.com\/qiniu.png\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\n\/\/\u6293\u53d6\u7f51\u7edc\u8d44\u6e90\u5230\u7a7a\u95f4\ntry {\n FetchRet fetchRet = bucketManager.fetch(remoteSrcUrl, bucket, key);\n System.out.println(fetchRet.hash);\n System.out.println(fetchRet.key);\n System.out.println(fetchRet.mimeType);\n System.out.println(fetchRet.fsize);\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u8d44\u6e90\u7ba1\u7406\u6279\u91cf\u64cd\u4f5c\n\n\n\n### \u6279\u91cf\u83b7\u53d6\u6587\u4ef6\u4fe1\u606f\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n String[] keyList = new String[]{\n \"qiniu.jpg\",\n \"qiniu.mp4\",\n \"qiniu.png\",\n };\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n batchOperations.addStatOps(bucket, keyList);\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (int i = 0; i < keyList.length; i++) {\n BatchStatus status = batchStatusList[i];\n String key = keyList[i];\n System.out.print(key+\"\\t\");\n if (status.code == 200) {\n \/\/\u6587\u4ef6\u5b58\u5728\n System.out.println(status.data.hash);\n System.out.println(status.data.mimeType);\n System.out.println(status.data.fsize);\n System.out.println(status.data.putTime);\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n### \u6279\u91cf\u4fee\u6539\u6587\u4ef6\u7c7b\u578b\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n HashMap<String, String> keyMimeMap = new HashMap<>();\n keyMimeMap.put(\"qiniu.jpg\", \"image\/jpg\");\n keyMimeMap.put(\"qiniu.png\", \"image\/png\");\n keyMimeMap.put(\"qiniu.mp4\", \"video\/mp4\");\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n\n \/\/\u6dfb\u52a0\u6307\u4ee4\n for (Map.Entry<String, String> entry : keyMimeMap.entrySet()) {\n String key = entry.getKey();\n String newMimeType = entry.getValue();\n batchOperations.addChgmOp(bucket, key, newMimeType);\n }\n\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n int index = 0;\n for (Map.Entry<String, String> entry : keyMimeMap.entrySet()) {\n String key = entry.getKey();\n System.out.print(key + \"\\t\");\n BatchStatus status = batchStatusList[index];\n if (status.code == 200) {\n System.out.println(\"change mime success\");\n } else {\n System.out.println(status.data.error);\n }\n index += 1;\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n### \u6279\u91cf\u5220\u9664\u6587\u4ef6\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n String[] keyList = new String[]{\n \"qiniu.jpg\",\n \"qiniu.mp4\",\n \"qiniu.png\",\n };\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n batchOperations.addDeleteOp(bucket, keyList);\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (int i = 0; i < keyList.length; i++) {\n BatchStatus status = batchStatusList[i];\n String key = keyList[i];\n System.out.print(key + \"\\t\");\n if (status.code == 200) {\n System.out.println(\"delete success\");\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n### \u6279\u91cf\u79fb\u52a8\u6216\u91cd\u547d\u540d\u6587\u4ef6\n\n```\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n String[] keyList = new String[]{\n \"qiniu.jpg\",\n \"qiniu.mp4\",\n \"qiniu.png\",\n };\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n for (String key : keyList) {\n batchOperations.addMoveOp(bucket, key, bucket, key + \"_move\");\n }\n\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (int i = 0; i < keyList.length; i++) {\n BatchStatus status = batchStatusList[i];\n String key = keyList[i];\n System.out.print(key + \"\\t\");\n if (status.code == 200) {\n System.out.println(\"move success\");\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n### \u6279\u91cf\u590d\u5236\u6587\u4ef6\n\n```\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n String[] keyList = new String[]{\n \"qiniu.jpg\",\n \"qiniu.mp4\",\n \"qiniu.png\",\n };\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n for (String key : keyList) {\n batchOperations.addCopyOp(bucket, key, bucket, key + \"_copy\");\n }\n\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (int i = 0; i < keyList.length; i++) {\n BatchStatus status = batchStatusList[i];\n String key = keyList[i];\n System.out.print(key + \"\\t\");\n if (status.code == 200) {\n System.out.println(\"copy success\");\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n### \u6279\u91cf\u89e3\u51bb\u5f52\u6863\u5b58\u50a8\u7c7b\u578b\u6587\u4ef6\n\n```\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n String[] keyList = new String[]{\n \"qiniu.jpg\",\n \"qiniu.mp4\",\n \"qiniu.png\",\n };\n int freezeAfterDays = 7 ;\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n for (String key : keyList) {\n batchOperations.addRestoreArchiveOps(bucket, freezeAfterDays, key);\n }\n\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (int i = 0; i < keyList.length; i++) {\n BatchStatus status = batchStatusList[i];\n String key = keyList[i];\n System.out.print(key + \"\\t\");\n if (status.code == 200) {\n System.out.println(\"restoreAr success\");\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n### \u6279\u91cf\u6df7\u5408\u6307\u4ee4\u64cd\u4f5c\n\n\u5176\u5b9e`batch`\u63a5\u53e3\u652f\u6301\u6df7\u5408\u6307\u4ee4\u7684\u5904\u7406\uff0c\u4e0d\u8fc7\u4e3a\u4e86\u65b9\u4fbf\u89e3\u6790\u8bf7\u6c42\u7684\u56de\u590d\uff0c\u4e00\u822c\u4e0d\u63a8\u8350\u8fd9\u6837\u505a\u3002\n\n```\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\n\ntry {\n \/\/\u5355\u6b21\u6279\u91cf\u8bf7\u6c42\u7684\u6587\u4ef6\u6570\u91cf\u4e0d\u5f97\u8d85\u8fc71000\n BucketManager.BatchOperations batchOperations = new BucketManager.BatchOperations();\n\n \/\/\u6dfb\u52a0\u6df7\u5408\u6307\u4ee4\n batchOperations.addStatOps(bucket, \"qiniu.png\", \"qiniu.jpg\");\n batchOperations.addCopyOp(bucket, \"qiniu.png\", bucket, \"qiniu_copy1.png\");\n batchOperations.addMoveOp(bucket, \"qiniu2.png\", bucket, \"qiniu3.png\");\n batchOperations.addDeleteOp(bucket, \"qiniu4.png\");\n batchOperations.addRestoreArchiveOps(bucket, 1, \"qiniu.png\");\n\n\n Response response = bucketManager.batch(batchOperations);\n BatchStatus[] batchStatusList = response.jsonToObject(BatchStatus[].class);\n\n for (BatchStatus status : batchStatusList) {\n if (status.code == 200) {\n System.out.println(\"operation success\");\n } else {\n System.out.println(status.data.error);\n }\n }\n} catch (QiniuException ex) {\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n## \u66f4\u65b0\u955c\u50cf\u5b58\u50a8\u7a7a\u95f4\u4e2d\u6587\u4ef6\u5185\u5bb9\n\n\u5bf9\u4e8e\u914d\u7f6e\u4e86\u955c\u50cf\u5b58\u50a8\u7684\u7a7a\u95f4\uff0c\u5982\u679c\u955c\u50cf\u6e90\u7ad9\u66f4\u65b0\u4e86\u6587\u4ef6\u5185\u5bb9\uff0c\u5219\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u79c1\u6709\u4e91\u5b58\u50a8\u4e0d\u4f1a\u518d\u4e3b\u52a8\u4ece\u5ba2\u6237\u955c\u50cf\u6e90\u7ad9\u540c\u6b65\u65b0\u7684\u526f\u672c\uff0c\u8fd9\u4e2a\u65f6\u5019\u5c31\u9700\u8981\u5229\u7528\u8fd9\u4e2a`prefetch`\u63a5\u53e3\u6765\u4e3b\u52a8\u5730\u5c06\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\u548c\u66f4\u65b0\u540e\u7684\u6e90\u7ad9\u526f\u672c\u8fdb\u884c\u540c\u6b65\u3002\u8c03\u7528\u65b9\u5f0f\u5f88\u7b80\u5355\uff0c\u6307\u5b9a\u7a7a\u95f4\u548c\u6587\u4ef6\u540d\u5373\u53ef\u3002\n\n```\n\/\/\u6784\u9020\u4e00\u4e2a\u5e26\u6307\u5b9a Region \u5bf9\u8c61\u7684\u914d\u7f6e\u7c7b\nConfiguration cfg = new Configuration(Region.region0());\n\/\/...\u5176\u4ed6\u53c2\u6570\u53c2\u8003\u7c7b\u6ce8\u91ca\n\nString accessKey = \"your access key\";\nString secretKey = \"your secret key\";\n\nString bucket = \"your bucket name\";\nString key = \"your file key\";\n\nAuth auth = Auth.create(accessKey, secretKey);\nBucketManager bucketManager = new BucketManager(auth, cfg);\ntry {\n bucketManager.prefetch(bucket, key);\n} catch (QiniuException ex) {\n \/\/\u5982\u679c\u9047\u5230\u5f02\u5e38\uff0c\u8bf4\u660e\u66f4\u65b0\u5931\u8d25\n System.err.println(ex.code());\n System.err.println(ex.response.toString());\n}\n```\n\n\n\n# \u8d21\u732e\u4ee3\u7801\n\n1. Fork\n2. \u521b\u5efa\u60a8\u7684\u7279\u6027\u5206\u652f git checkout -b my-new-feature\n3. \u63d0\u4ea4\u60a8\u7684\u6539\u52a8 git commit -am 'Added some feature'\n4. \u5c06\u60a8\u7684\u4fee\u6539\u8bb0\u5f55\u63d0\u4ea4\u5230\u8fdc\u7a0b git \u4ed3\u5e93 git push origin my-new-feature\n5. \u7136\u540e\u5230 github \u7f51\u7ad9\u7684\u8be5 git \u8fdc\u7a0b\u4ed3\u5e93\u7684 my-new-feature \u5206\u652f\u4e0b\u53d1\u8d77 Pull Request\n\n\n\n\n"}