表单上传(JAVA)

最近更新时间:2021-12-16 11:41:52

  1. 了解KS3表单上传协议,以及表单上传签名认证方式
  2. KS3控制台->空间设置->CORS配置里配置CORS跨域规则。CORS为跨域资源共享,当使用js跨域时,需要配置该规则。W3C文档
  3. 使用js sdk上传文件:
  4. js sdk 中的policy和signature可以通过Java SDK的该方法计算出来。
public PostObjectFormFields postObjectSimple() {
       // yourEndpoint填写Bucket所在地域对应的Endpoint。以中国(北京)为例,Endpoint填写为ks3-cn-beijing.ksyuncs.com。如果使用自定义域名,设置endpoint为自定义域名,同时设置domainMode为true
       String endpoint = "yourEndpoint";
       // 金山云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用子账号账号进行 API 访问或日常运维,请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
       String accessKeyId = "yourAccessKeyId";
       String accessKeySecret = "yourAccessKeySecret";
       // 创建Ks3ClientConfig 实例。
       Ks3ClientConfig config = new Ks3ClientConfig();
       // 设置域名
       config.setEndpoint(endpoint);
       // 创建Ks3Client实例
       Ks3 client = new Ks3Client(accessKeyId, accessKeySecret, config);
       /**
       * 需要用户在postData和unknowValueField中提供所有的除KSSAccessKeyId, signature, file, policy外的所有表单项。否则用生成的签名上传会返回403</br>
       * 对于用户可以确定表单值的放在 postData中,对于用户无法确定表单值的放在unknownValueField中(比如有的上传控件会添加一些表单项,但表单项的值可能是随机的)</br>
       */
       Map<String, String> postData = new HashMap<String, String>();
       // 如果使用js sdk上传的时候设置了ACL,请提供以下一行,且值要与SDK中一致,否则删除下面一行代码
       postData.put("acl","public-read");
       // 提供js sdk中的key值
       postData.put("key","20150115/中文/${filename}");
       // 设置无法确定的表单值
       List<String> unknowValueField = new ArrayList<String>();
       // js sdk上传的时候会自动加上一个name的表单项,所以下面需要加上这样的代码。
       unknowValueField.add("name");      
       // 如果计算签名时提供的key里不包含${filename}占位符,第二个参数传一个空字符串。
       PostObjectFormFields fields = client.postObject("<您的bucket名称>", "<要上传的文件名称,不包含路径信息>", postData, unknowValueField);
       // 获取KssAccessKeyId
       fields.getKssAccessKeyId();
       // 获取 post 的 policy 
       fields.getPolicy();
       // 获取 signature
       fields.getSignature();
       // 返回 policy 相关信息
       return fields;
}

常见问题:

  • 上传时,浏览器一共会发送两个请求,第一个为OPTIONS请求,第二个为POST请求。如果第一个请求返回403,请检测CORS配置是否正确。如果第二个请求返回403,请检查生成policy时,是否完全按照表单内容生成。或者把policy进行base64解码,对比表单内容是否正确。对比规则:Policy、Signature构建方法

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈