判断对象是否存在

功能介绍

判断对象是否存在，返回的结果中HTTP状态码为200表明对象存在，返回404表明对象或桶不存在。

接口约束

• 您必须是桶拥有者或拥有获取对象元数据的权限，才能判断对象是否存在。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:GetObject权限，如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。
• OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。

方法定义

obsClient.doesObjectExist(final GetObjectMetadataRequest request)

请求参数说明

返回结果说明

代码示例

以下代码展示如何判断examplebucket桶中objectname对象是否存在。

import android.util.Log;

import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.GetObjectMetadataRequest;

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

    public void doesObjectExist() {
        // 认证用的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");
        // endpoint填写桶所在的endpoint, 此处以华北-北京四为例，其他地区请按实际情况填写。
        String endPoint = "https://your-endpoint";

        // 创建ObsClient实例
        ObsClient obsClient = new ObsClient(ak, sk, endPoint);

        try {
            // 判断指定的对象是否存在
            boolean exists = obsClient.doesObjectExist("examplebucket", "objectname");
            Log.i(TAG, exists ? "object exists!" : "object does not exist!");
            Log.i(TAG, "doesObjectExist successfully");

            // 也可使用GetObjectMetadataRequest方式
            GetObjectMetadataRequest request = new GetObjectMetadataRequest("examplebucket", "objectname");
            boolean exists2 = obsClient.doesObjectExist(request);
            Log.i(TAG, exists2 ? "object exists!" : "object does not exist!");
        } catch (ObsException e) {
            Log.e(TAG, "doesObjectExist failed");
            // 请求失败,打印http状态码
            Log.e(TAG, "HTTP Code:" + e.getResponseCode());
            // 请求失败,打印服务端错误码
            Log.e(TAG, "Error Code:" + e.getErrorCode());
            // 请求失败,打印详细错误信息
            Log.e(TAG, "Error Message:" + e.getErrorMessage());
            // 请求失败,打印请求id
            Log.e(TAG, "Request ID:" + e.getErrorRequestId());
            Log.e(TAG, "Host ID:" + e.getErrorHostId());
        } catch (Exception e) {
            Log.e(TAG, "doesObjectExist failed");
            // 其他异常信息打印
            Log.e(TAG, e.getMessage());
        }
    }
}