下载归档存储对象

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

如果要下载归档存储对象，需要先将归档存储对象恢复。恢复归档存储对象时可选择的恢复选项有两类，见下表：

重复恢复归档存储数据时在延长恢复有效期的同时，也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类型的对象副本有效期将会延长，并且收取延长时间段产生的标准存储副本费用。

您可以通过ObsClient.restoreObject恢复归档存储对象。以下代码展示了如何下载归档存储对象：

import android.util.Log;
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.HeaderResponse;
import com.obs.services.model.ObsObject;
import com.obs.services.model.RestoreObjectRequest;
import com.obs.services.model.RestoreTierEnum;
import java.io.IOException;
import java.io.InputStream;

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

    public void restoreAndDownloadObject() {
        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 {
                    String bucketName = "examplebucket";
                    String objectKey = "objectname";

                    // 发起恢复请求
                    RestoreObjectRequest request = new RestoreObjectRequest();
                    request.setBucketName(bucketName);
                    request.setObjectKey(objectKey);
                    // 设置恢复后保持天数为1天
                    request.setDays(1);
                    // 设置恢复选项为快速恢复（1~5分钟内完成）
                    request.setRestoreTier(RestoreTierEnum.EXPEDITED);
                    HeaderResponse response = obsClient.restoreObject(request);
                    Log.i(TAG, "Restore object successfully");
                    Log.i(TAG, "HTTP Code:" + response.getStatusCode());

                    // 等待对象恢复完成
                    // 快速恢复通常需要1~5分钟，此处等待6分钟后尝试下载
                    // 标准恢复可能需要3~5小时，请根据实际恢复选项调整等待时间
                    Thread.sleep(6 * 60 * 1000);

                    // 下载已恢复的对象
                    ObsObject obsObject = obsClient.getObject(bucketName, objectKey);
                    // 使用 try-with-resources 确保 InputStream 在任何情况下都能被关闭
                    try (InputStream input = obsObject.getObjectContent()) {
                        Log.i(TAG, "Download object successfully");
                        Log.i(TAG, "Object size:" + obsObject.getMetadata().getContentLength());
                    } catch (IOException e) {
                        Log.e(TAG, "Failed to read object content", e);
                    }
                } catch (ObsException e) {
                    Log.e(TAG, "Restore and download 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 (InterruptedException e) {
                    Log.e(TAG, "Thread interrupted while waiting for restore");
                    Thread.currentThread().interrupt();
                } catch (Exception e) {
                    Log.e(TAG, "Restore and download failed");
                    Log.e(TAG, e.getMessage());
                } finally {
                    try {
                        obsClient.close();
                    } catch (Exception e) {
                        // 忽略关闭异常
                    }
                }
            }
        }).start();
    }
}

• ObsClient.restoreObject中指定的对象必须是归档存储类型，否则调用该接口会抛出异常。
• RestoreObjectRequest.setDays指定恢复对象保存的时间，取值范围是1~30，单位：天。
• RestoreObjectRequest.setTier指定恢复选项，取值范围是RestoreTierEnum.EXPEDITED、RestoreTierEnum.STANDARD。