基于表单上传
开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。
基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。
您可以通过ObsClient.createPostSignature生成基于表单上传的请求参数。使用代码模拟表单上传的完整代码示例,参见PostObjectSample。您也可以通过如下步骤进行表单上传:
- 使用ObsClient.createPostSignature生成用于鉴权的请求参数。
- 准备表单HTML页面。
- 将生成的请求参数填入HTML页面。
- 选择本地文件,进行表单上传。
使用SDK生成用于鉴权的请求参数包括两个:
- policy,对应表单中policy字段。
- signature,对应表单中的signature字段。
以下代码展示了如何生成基于表单上传的请求参数:
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY_ID。 // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html String ak = System.getenv("ACCESS_KEY_ID"); String sk = System.getenv("SECRET_ACCESS_KEY_ID"); String endPoint = "https://your-endpoint"; // 创建ObsClient实例 final ObsClient obsClient = new ObsClient(ak, sk, endPoint); PostSignatureRequest request = new PostSignatureRequest(); // 设置表单参数 Map<String, Object> formParams = new HashMap<String, Object>(); // 设置对象访问权限为公共读 formParams.put("x-obs-acl", "public-read"); // 设置对象MIME类型 formParams.put("content-type", "text/plain"); request.setFormParams(formParams); // 设置表单上传请求有效期,单位:秒 request.setExpires(3600); PostSignatureResponse response = obsClient.createPostSignature(request); // 获取表单上传请求参数 Log.i("CreatePostSignature", "\t" + response.getPolicy()); Log.i("CreatePostSignature", "\t" + response.getSignature());
示例表单HTML代码如下:
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> </head> <body> <form action="http://bucketname.your-endpoint/" method="post" enctype="multipart/form-data"> Object key <!-- 对象名 --> <input type="text" name="key" value="objectname" /> <p> ACL <!-- 对象ACL权限 --> <input type="text" name="x-obs-acl" value="public-read" /> <p> Content-Type <!-- 对象MIME类型 --> <input type="text" name="content-type" value="text/plain" /> <p> <!-- policy的base64编码值 --> <input type="hidden" name="policy" value="*** Provide your policy ***" /> <!-- AK --> <input type="hidden" name="AccessKeyId" value="*** Provide your access key ***"/> <!-- 签名串信息 --> <input type="hidden" name="signature" value="*** Provide your signature ***"/> <input name="file" type="file" /> <input name="submit" value="Upload" type="submit" /> </form> </body> </html>
- HTML表单中的policy,signature的值均是从ObsClient.createPostSignature的返回结果中获取。
- 您可以直接下载表单HTML示例PostDemo。