设置对象属性

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

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

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

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

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

    public void setObjectMetadata() {
        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 {
                    SetObjectMetadataRequest request = new SetObjectMetadataRequest("examplebucket", "objectname");
                    // 对象的 HTTP 标准头域，请根据实际情况修改传入值
                    request.setExpires("Wed, 21 Oct 2025 07:28:00 GMT");
                    request.setContentType("text/plain");
                    // 设置自定义元数据
                    request.addUserMetadata("property1", "property-value1");

                    ObjectMetadata metadata = obsClient.setObjectMetadata(request);
                    Log.i(TAG, "Set object metadata successfully");
                    Log.i(TAG, "property1: " + metadata.getUserMetadata("property1"));
                } catch (ObsException e) {
                    Log.e(TAG, "Set 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, "Set object metadata failed");
                    Log.e(TAG, e.getMessage());
                } finally {
                    try {
                        obsClient.close();
                    } catch (Exception e) {
                        // 忽略关闭异常
                    }
                }
            }
        }).start();
    }
}

以下代码展示了如何设置对象过期时间：

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

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

    public void setObjectExpires() {
        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 {
                    SetObjectMetadataRequest request = new SetObjectMetadataRequest("examplebucket", "objectname");
                    HashMap<String, String> userHeaders = new HashMap<>();
                    // 设置对象过期时间5天
                    userHeaders.put("x-obs-expires", "5");
                    // 需设置元数据保存方式为REPLACE_NEW，否则不会覆盖原有元数据
                    userHeaders.put("x-obs-metadata-directive", "REPLACE_NEW");
                    request.setUserHeaders(userHeaders);

                    ObjectMetadata metadata = obsClient.setObjectMetadata(request);
                    Log.i(TAG, "Set object expires successfully");                    
                } catch (ObsException e) {
                    Log.e(TAG, "Set object expires 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, "Set object expires failed");
                    Log.e(TAG, e.getMessage());
                } finally {
                    try {
                        obsClient.close();
                    } catch (Exception e) {
                        // 忽略关闭异常
                    }
                }
            }
        }).start();
    }
}

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