Java-SDK之如何实现上传文件（五）？

获取已上传的分片


获取上传的分片可以罗列出指定Upload ID所属的所有已经上传成功的分片。可以调用OSSClient.listParts获取某个上传事件所有已上传分片。listParts的可设置的参数如下：

参数	作用	方法
UploadId	Upload Id，initiateMultipartUpload返回的结果获取。	ListPartsRequest.setUploadId(String uploadId)
MaxParts	OSS响应中的最大Part数目，即分页时每一页中Part数目。	ListPartsRequest.setMaxParts(int maxParts)
PartNumberMarker	指定List的起始位置，只有Part Number数目大于该参数的Part会被列出。	ListPartsRequest.setPartNumberMarker(Integer partNumberMarker)

简单列举

1. // endpoint以杭州为例，其它region请按实际情况填写
2. String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
3. // 云账号AccessKey有所有API访问权限，建议遵循阿里云安全最佳实践，创建并使用RAM子账号进行API访问或日常运维，请登录 https://ram.console.aliyun.com 创建
4. String accessKeyId = "<yourAccessKeyId>";
5. String accessKeySecret = "<yourAccessKeySecret>";
7. // 创建OSSClient实例
8. OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
9. // 列举已上传的分片，其中uploadId来自于initiateMultipartUpload        
10. ListPartsRequest listPartsRequest = new ListPartsRequest("<yourBucketName>", "<yourKey>", "<uploadId>");
11. PartListing partListing = ossClient.listParts(listPartsRequest);
12. for (PartSummary part : partListing.getParts()) {
13.     // 分片号，上传时候指定
14.     part.getPartNumber();
15.     // 分片数据大小
16.     part.getSize();
17.     // Part的ETag
18.     part.getETag();
19.     // Part的最后修改上传
20.     part.getLastModified();
21. }
22. // 关闭client
23. ossClient.shutdown();

提示：

• 默认情况下，如果存储空间中的分片上传事件的数量大于1000，则只会返回1000个Multipart Upload信息，且返回结果中 IsTruncated 为false，并返回 NextPartNumberMarker作为下此读取的起点。
• 如果没有一次性获取所有的上传分片，可以采用分页列举的方式。

获取所有已上传分片


默认情况下，listParts只能列举1000个分片，如果分片数量大于1000，列举所有分片请参考如下示例。

1. // endpoint以杭州为例，其它region请按实际情况填写
2. String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
3. // 云账号AccessKey有所有API访问权限，建议遵循阿里云安全最佳实践，创建并使用RAM子账号进行API访问或日常运维，请登录 https://ram.console.aliyun.com 创建
4. String accessKeyId = "<yourAccessKeyId>";
5. String accessKeySecret = "<yourAccessKeySecret>";
7. // 创建OSSClient实例
8. OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
9. // 列举所有已上传的分片    
10. PartListing partListing;
11. ListPartsRequest listPartsRequest = new ListPartsRequest("<yourBucketName>", "<yourKey>", "<uploadId>");
12. do {
13.     partListing = ossClient.listParts(listPartsRequest);
14.     for (PartSummary part : partListing.getParts()) {
15.         // 分片号，上传时候指定
16.         part.getPartNumber();
17.         // 分片数据大小
18.         part.getSize();
19.         // Part的ETag
20.         part.getETag();
21.         // Part的最后修改上传
22.         part.getLastModified();
23.     }
24.     listPartsRequest.setPartNumberMarker(partListing.getNextPartNumberMarker());
25. } while (partListing.isTruncated());
26. // 关闭client
27. ossClient.shutdown()

分页获取所有分片


默认情况下，listParts一次列举1000个分片，上面的获取所有已上传分片也是分页的一种特殊情况，每页1000个分片。如果需要指定每页分片的数量，即一次列举的分片数量，请参考以下代码。

1. // endpoint以杭州为例，其它region请按实际情况填写
2. String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
3. // 云账号AccessKey有所有API访问权限，建议遵循阿里云安全最佳实践，创建并使用RAM子账号进行API访问或日常运维，请登录 https://ram.console.aliyun.com 创建
4. String accessKeyId = "<yourAccessKeyId>";
5. String accessKeySecret = "<yourAccessKeySecret>";
7. // 创建OSSClient实例
8. OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
9. // 分页列举已上传的分片    
10. PartListing partListing;
11. ListPartsRequest listPartsRequest = new ListPartsRequest("<yourBucketName>", "<yourKey>", "<uploadId>");
12. // 每页100个分片
13. listPartsRequest.setMaxParts(100);
14. do {
15.     partListing = ossClient.listParts(listPartsRequest);
16.     for (PartSummary part : partListing.getParts()) {
17.         // 分片号，上传时候指定
18.         part.getPartNumber();
19.         // 分片数据大小
20.         part.getSize();
21.         // Part的ETag
22.         part.getETag();
23.         // Part的最后修改上传
24.         part.getLastModified();
25.     }
26.     listPartsRequest.setPartNumberMarker(partListing.getNextPartNumberMarker());
27. } while (partListing.isTruncated());
28. // 关闭client
29. ossClient.shutdown();

获取存储空间内所有分片上传事件


列举分片上传事件可以罗列出所有执行中的分片上传事件，即已经初始化的尚未Complete或者Abort的分片上传事件。列举分片上传的可设置的参数如下：

参数	作用	方法
Prefix	限定返回的文件名(object)必须以Prefix作为前缀。注意使用Prefix查询时，返回的文件名(Object)中仍会包含Prefix。	ListMultipartUploadsRequest.setPrefix(String prefix)
Delimiter	用于对Object名字进行分组的字符。所有名字包含指定的前缀且第一次出现delimiter字符之间的object作为一组元素。	ListMultipartUploadsRequest.setDelimiter(String delimiter)
MaxUploads	限定此次返回分片上传事件的最大数目，默认为1000，MaxUploads取值不能大于1000。	ListMultipartUploadsRequest.setMaxUploads(Integer maxUploads)
KeyMarker	所有Object名字的字典序大于KeyMarker参数值的Multipart事件。可以与UploadIdMarker参数一同使用来指定返回结果的起始位置。	ListMultipartUploadsRequest.setKeyMarker(String keyMarker)
UploadIdMarker	与KeyMarker参数一同使用来指定返回结果的起始位置。 如果KeyMarker参数未设置，则OSS忽略UploadIdMarker参数。 如果KeyMarker参数被设置，查询结果中包含：所有Object名字的字典序大于KeyMarker参数值和Object名字等于KeyMarker参数值且Upload ID比UploadIdMarker参数值大的分片上传事件。	ListMultipartUploadsRequest.setUploadIdMarker(String uploadIdMarker)

调用OSSClient.listMultipartUploads获取存储空间内分片上传事件。