更新时间:2024-12-03 GMT+08:00

设置对象属性

您可以通过ObsClient.setObjectMetadata来设置对象属性,包括对象自定义元数据等信息。

除了 HTTP 标准头域外,您也可以指定自定义元数据,自定义元数据仅支持英文字符、数字与中划线【-】。

以下代码展示了如何设置对象属性:

// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY_ID。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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);

SetObjectMetadataRequest request = new SetObjectMetadataRequest("bucketname", "objectname");
// 对象的 HTTP 标准头域
request.setContentType("ContentType");
request.setExpires("Expires");
// 设置自定义元数据
request.addUserMetadata("property1", "property-value1");

ObjectMetadata metadata = obsClient.setObjectMetadata(request);

Log.i("\t" + metadata.getUserMetadata("property1"));
  • 由于 HTTP 编码规范限制,无法发送非 ASCII 码字符,SDK 会在发送请求时对您头域中的中文汉字进行 url 编码,发送编码后数据。如您设置的值 content-disposition 为 “attachment; filename="中文.txt"”,则对象元数据中存储的信息为“attachment; filename="%E4%B8%AD%E6%96%87.txt"”。使用浏览器访问时浏览器将会自动解码。
  • 如果不需要 SDK 帮您编码,可以调用 SetObjectMetadataRequest.setIsEncodeHeaders(false) 关闭自动编码。