更新时间:2026-09-10 GMT+08:00
分享

获取对象属性

开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

您可以通过ObsClient.getObjectMetadata来获取对象属性,包括对象长度,对象MIME类型,对象自定义元数据等信息。以下代码展示了如何获取对象属性:

import android.util.Log;
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.ObjectMetadata;

public class GetObjectMetadataDemo {
    private static final String TAG = "GetObjectMetadataDemo";

    public void getObjectMetadata() {
        new Thread(new Runnable() {
            @Override
            public void run() {
                // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY_ID。
                // 您可以登录访问管理控制台获取访问密钥AK/SK
                String ak = System.getenv("ACCESS_KEY_ID");
                String sk = System.getenv("SECRET_ACCESS_KEY_ID");
                String endPoint = "https://your-endpoint";

                // 创建ObsClient实例
                ObsClient obsClient = new ObsClient(ak, sk, endPoint);
                try {
                    ObjectMetadata metadata = obsClient.getObjectMetadata("examplebucket", "objectname");
                    Log.i(TAG, "Get object metadata successfully");
                    // 获取对象MIME类型
                    Log.i(TAG, "ContentType: " + metadata.getContentType());
                    // 获取对象长度
                    Log.i(TAG, "ContentLength: " + metadata.getContentLength());
                    // 获取用户自定义元数据,以property为例
                    Log.i(TAG, "property: " + metadata.getUserMetadata("property"));
                    // 获取所有原始响应头域
                    Log.i(TAG, "OriginalHeaders: " + metadata.getOriginalHeaders());
                } catch (ObsException e) {
                    Log.e(TAG, "Get object metadata failed");
                    Log.e(TAG, "HTTP Code:" + e.getResponseCode());
                    Log.e(TAG, "Error Code:" + e.getErrorCode());
                    Log.e(TAG, "Error Message:" + e.getErrorMessage());
                    Log.e(TAG, "Request ID:" + e.getErrorRequestId());
                    Log.e(TAG, "Host ID:" + e.getErrorHostId());
                } catch (Exception e) {
                    Log.e(TAG, "Get object metadata failed");
                    Log.e(TAG, e.getMessage());
                } finally {
                    try {
                        obsClient.close();
                    } catch (Exception e) {
                        // 忽略关闭异常
                    }
                }
            }
        }).start();
    }
}
  • 由于 HTTP 编码规范限制,无法发送非 ASCII 码字符,SDK 会在接收响应时使用 url 解码规则解码响应头中的信息。如您的元数据存储的 content-disposition 为“attachment; filename="%E4%B8%AD%E6%96%87.txt"”,则 SDK 获取结果为“attachment; filename="中文.txt"”。
  • 如果不需要 SDK 帮您解码,可以调用 GetObjectMetadataRequest.setIsEncodeHeaders(false) 关闭自动解码。
  • 您也可以通过 metadata.getOriginalHeaders 获取所有原始响应头的信息。

相关文档