下载文件
BOS Java SDK提供了丰富的文件下载接口，用户可以通过以下方式从BOS中下载文件：
- 简单流式下载
- 下载到本地文件
- 断点续传下载
- 范围下载
- 下载进度条
完整示例代码请参考下载文件Demo
简单流式下载
用户可以通过如下代码将Object读取到一个流中：
1public void getObject(BosClient client, String bucketName, String objectKey)
2 throws IOException {
3
4 // 获取Object，返回结果为BosObject对象
5 BosObject object = client.getObject(bucketName, objectKey);
6
7 // 获取ObjectMeta
8 ObjectMetadata meta = object.getObjectMetadata();
9
10 // 获取Object的输入流
11 InputStream objectContent = object.getObjectContent();
12
13 // 处理Object
14 ...
15
16 // 关闭流
17 objectContent.close();
18}注意：
- BosObject中包含了Object的各种信息，包含Object所在的Bucket、Object的名称、MetaData以及一个输入流，用户可以通过操作输入流将Object的内容读取到文件或者内存中。
- ObjectMetadata中包含了Object上传时定义的ETag，Http Header以及自定义的元数据。
- 通过BosObject的getObjectContent方法，还可以获取返回Object的输入流，用户可以读取这个输入流来对Object的内容进行操作。
直接下载Object到文件
用户可以通过如下代码直接将Object下载到指定文件：
1// 新建GetObjectRequest
2GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, objectKey);
3
4// 下载Object到文件
5ObjectMetadata objectMetadata = client.getObject(getObjectRequest, new File("/path/to/file","filename"));当使用上面方法将Object直接下载到文件时，方法返回ObjectMetadata对象。
范围下载
为了实现更多的功能，可以通过使用GetObjectRequest来指定下载范围，实现更精细化地获取Object。如果指定的下载范围是0 - 100，则返回第0到第100个字节的数据，包括第100个，共101字节的数据，即[0, 100]。
1// 新建GetObjectRequest
2GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, objectKey);
3
4// 获取0~100字节范围内的数据
5getObjectRequest.setRange(0, 100);
6
7// 获取Object，返回结果为BosObject对象
8BosObject object = client.getObject(getObjectRequest);通过getObjectRequest的setRange方法可以设置返回Object的范围。用户也可以用此功能实现文件的分段下载和断点续传。
下载图像处理后的文件
java sdk支持下载文件的同时进行图像处理。在请求种设置x-bce-process参数即可。具体参数使用参考图像处理。示例代码如下：
1// 新建GetObjectRequest
2
3GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, objectKey);
4
5// 设置图像处理为缩放
6getObjectRequest.setxBceProcess("image/resize,m_fixed,w_200,h_100");
7
8// 获取Object，返回结果为处理后的BosObject对象
9BosObject object = client.getObject(getObjectRequest);其他使用方法
获取Object的存储类型
Object的storage class属性分为STANDARD(标准存储), STANDARD_IA(低频存储)和COLD(冷存储)，通过如下代码可以实现：
1public void getObjectStorageClass(){
2 ObjectMetadata meta = client.getObjectMetadata(bucketName, key);
3 String storageClass = meta.getStorageClass();
4}只获取ObjectMetadata
通过 getObjectMetadata 方法可以只获取ObjectMetadata而不获取Object的实体。如下代码所示：
1ObjectMetadata objectMetadata = client.getObjectMetadata(bucketName, objectKey);getObjectMetadata方法返回的解析类中可供调用的参数有：
| 参数 | 说明 |
|---|---|
| contentType | Object的类型 |
| contentLength | Object的大小 |
| contentMd5 | Object的MD5 |
| etag | Object的HTTP协议实体标签 |
| storageClass | Object的存储类型 |
| userMetadata | 如果在PutObject指定了userMetadata自定义meta，则返回此项 |
| xBceCrc | 如果在PutObject指定了object的CRC值(循环冗余校验码)，则返回此项 |
单链接限速
对象存储BOS的单Bucket带宽是有限制的，当用户的上传或下载占用带宽达到带宽限制阈值时，会返回RequestRateLimitExceeded的错误码。
为保证用户能够正常使用服务，BOS支持在进行上传、下载等行为时进行流量控制，保证大流量服务占用带宽不会对其他应用服务造成影响。
下载接口支持设置指定限速值，限速值的取值范围为819200~838860800，单位为bit/s，即100KB/s~100MB/s。限速值取值必须为数字，BOS将按照指定的限速值对此次请求进行限速，当限速值不在此范围或不合法时将返回错误。
- GetObject示例代码：
1GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, objectKey);
2// 指定下载的限速值为819200bit/s，即100KB/s
3getObjectRequest.setTrafficLimitBitPS(819200);
4ObjectMetadata objectMetadata = client.getObject(getObjectRequest, new File("/path/to/file","filename"));下载进度条
SDK支持在上传过程中实时提供上传进度信息。Java SDK定义的上传进度回调接口如下，您可以在其中定义上传过程中您所需要的操作，如更新界面等等。
1public interface ProgressCallback<T> {
2 void onProgress(long currentSize, long totalSize, T data);
3}- GetObject示例代码：
1File file = new File("tmp-download");
2BosProgressCallback<Object> callback = new BosProgressCallback<Object>() {
3 @Override
4 public void onProgress(long currentSize, long totalSize, Object data) {
5 System.out.println("get " + currentSize + "/" + totalSize);
6 }
7};
8GetObjectRequest getObjectRequest = new GetObjectRequest("bucketName","objectKey");
9getObjectRequest.setProgressCallback(callback);
10this.client.getObject(getObjectRequest, file);