简单获取对象

适用场景

您可以直接发起请求获取 COS 中的对象，获取对象支持以下功能：

• 获取完整的单个对象：直接发起 GET 请求即可获取完整的对象数据。

• 获取单个对象的部分内容：可在 GET 请求中传入 Range 请求头部，支持检索一个特定的字节范围。不支持检索多个范围。

  对象的元数据将会作为 HTTP 响应头部随对象内容一同返回，GET 请求支持使用 URL 参数的方式覆盖响应的部分元数据值，例如 Content-Dispositon 的响应值。支持修改的响应头部包括：

• Content-Type

• Content-Language

• Expires

• Cache-Control

• Content-Disposition

• Content-Encoding

使用方法

使用 REST API

您可以直接使用 REST API 发起一个获取对象请求，可参考 GET Object 文档说明。

使用 Java SDK

对象存储 COS 的 Java SDK 中提供了此方法，可参考 Java SDK 接口文档 Get Object 部分。

步骤说明

1. 初始化客户端 cosclient。

2. 执行 getObject 方法获取输入流或者将内容保存到本地。

代码示例

1. 以下代码演示了如何下载对象（无版本控制）：

   // 1 初始化用户身份信息(appid, secretId, secretKey)  
   COSCredentials cred = new BasicCOSCredentials("1250000", "AKIDXXXXXXXX", "1A2Z3YYYYYYYYYY");  
   // 2 设置bucket的区域, COS地域的简称请参照 /document/product/436/6224
   ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing-1"));  
   // 3 生成cos客户端  
   COSClient cosclient = new COSClient(cred, clientConfig);
   // 设置bucket名  
   String bucketName = "mybucket";
   String key = "aaa.txt";
   
   try {
       // 下载文件  
       COSObject cosObject = cosclient.getObject(bucketName, key);
       // 获取输入流  
       COSObjectInputStream cosObjectInput = cosObject.getObjectContent();
       // 关闭输入流  
       cosObjectInput.close();
   } catch (CosServiceException e) {
       e.printStackTrace();
   } catch (CosClientException e) {
       e.printStackTrace();
   }   

2. GetObjectRequest 支持指定要从对象检索的数据字节范围，以下代码演示了指定字节的方法：

   // 1 初始化用户身份信息(appid, secretId, secretKey)  
   COSCredentials cred = new BasicCOSCredentials("1250000", "AKIDXXXXXXXX", "1A2Z3YYYYYYYYYY");    
   // 2 设置bucket的区域, COS地域的简称请参照 /document/product/436/6224
   ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing-1"));    
   // 3 生成cos客户端  
   COSClient cosclient = new COSClient(cred, clientConfig);
   // 设置bucket名
   String bucketName = "mybucket";
   String key = "aaa.txt";
   
   try {
       GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, key);
       // 设置下载前11个字节  
       getObjectRequest.setRange(0, 10);
       // 下载文件  
       COSObject cosObject = cosclient.getObject(bucketName, key);
       // 获取输入流  
       COSObjectInputStream cosObjectInput = cosObject.getObjectContent();
       // 关闭输入流  
       cosObjectInput.close();
   } catch (CosServiceException e) {
       e.printStackTrace();
   } catch (CosClientException e) {
       e.printStackTrace();
   }   

3. 检索对象时还可以用 ResponseHeaderOverrides 对象并设置相应的请求属性来替换响应头部值，以下是该方法的示例：

   // 1 初始化用户身份信息(appid, secretId, secretKey)   
   COSCredentials cred = new BasicCOSCredentials("1250000", "AKIDXXXXXXXX", "1A2Z3YYYYYYYYYY");
   // 2 设置bucket的区域, COS地域的简称请参照 /document/product/436/6224  
   ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing-1"));  
   // 3 生成cos客户端  
   COSClient cosclient = new COSClient(cred, clientConfig);  
   // 设置bucket名  
   String bucketName = "mybucket";
   String key = "aaa.txt";
   
   try {
       GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, key);
       ResponseHeaderOverrides responseHeaders = new ResponseHeaderOverrides();
       String responseContentType="image/x-icon";
       String responseContentEncoding = "gzip,deflate,compress";
       String responseContentLanguage = "zh-CN";
       String responseContentDispositon = "filename=\"abc.txt\"";
       String responseCacheControl = "no-cache";
       String expireStr = DateUtils.formatRFC822Date(new Date(System.currentTimeMillis() + 24 * 3600 * 1000));
       responseHeaders.setContentType(responseContentType);
       responseHeaders.setContentEncoding(responseContentEncoding);
       responseHeaders.setContentLanguage(responseContentLanguage);
       responseHeaders.setContentDisposition(responseContentDispositon);
       responseHeaders.setCacheControl(responseCacheControl);
       responseHeaders.setExpires(expireStr);
       getObjectRequest.setResponseHeaders(responseHeaders);
       // 下载文件
       COSObject cosObject = cosclient.getObject(bucketName, key);
       // 获取输入流
       COSObjectInputStream cosObjectInput = cosObject.getObjectContent();
       // 关闭输入流
       cosObjectInput.close();
   } catch (CosServiceException e) {
       e.printStackTrace();
   } catch (CosClientException e) {
       e.printStackTrace();
   }