Android-SDK 之如何实现上传文件（一）?

简单上传本地文件


调用同步接口上传：

1. // 构造上传请求
2. PutObjectRequest put = new PutObjectRequest("<bucketName>", "<objectKey>", "<uploadFilePath>");
4. // 文件元信息的设置是可选的
5. // ObjectMetadata metadata = new ObjectMetadata();
6. // metadata.setContentType("application/octet-stream"); // 设置content-type
7. // metadata.setContentMD5(BinaryUtil.calculateBase64Md5(uploadFilePath)); // 校验MD5
8. // put.setMetadata(metadata);
10. try {
12.     PutObjectResult putResult = oss.putObject(put);
14.     Log.d("PutObject", "UploadSuccess");
16.     Log.d("ETag", putResult.getETag());
17.     Log.d("RequestId", putResult.getRequestId());
18. } catch (ClientException e) {
19.     // 本地异常如网络异常等
20.     e.printStackTrace();
21. } catch (ServiceException e) {
22.     // 服务异常
23.     Log.e("RequestId", e.getRequestId());
24.     Log.e("ErrorCode", e.getErrorCode());
25.     Log.e("HostId", e.getHostId());
26.     Log.e("RawMessage", e.getRawMessage());
27. }

注意：在Android中，不能在UI线程调用同步接口，只能在子线程调用，否则将出现异常。如果希望直接在UI线程中上传，请使用异步接口。

调用异步接口上传：

1. // 构造上传请求
2. PutObjectRequest put = new PutObjectRequest("<bucketName>", "<objectKey>", "<uploadFilePath>");
4. // 异步上传时可以设置进度回调
5. put.setProgressCallback(new OSSProgressCallback<PutObjectRequest>() {
6.     @Override
7.     public void onProgress(PutObjectRequest request, long currentSize, long totalSize) {
8.         Log.d("PutObject", "currentSize: " + currentSize + " totalSize: " + totalSize);
9.     }
10. });
12. OSSAsyncTask task = oss.asyncPutObject(put, new OSSCompletedCallback<PutObjectRequest, PutObjectResult>() {
13.     @Override
14.     public void onSuccess(PutObjectRequest request, PutObjectResult result) {
15.         Log.d("PutObject", "UploadSuccess");
17.         Log.d("ETag", result.getETag());
18.         Log.d("RequestId", result.getRequestId());
19.     }
21.     @Override
22.     public void onFailure(PutObjectRequest request, ClientException clientExcepion, ServiceException serviceException) {
23.         // 请求异常
24.         if (clientExcepion != null) {
25.             // 本地异常如网络异常等
26.             clientExcepion.printStackTrace();
27.         }
28.         if (serviceException != null) {
29.             // 服务异常
30.             Log.e("ErrorCode", serviceException.getErrorCode());
31.             Log.e("RequestId", serviceException.getRequestId());
32.             Log.e("HostId", serviceException.getHostId());
33.             Log.e("RawMessage", serviceException.getRawMessage());
34.         }
35.     }
36. });
38. // task.cancel(); // 可以取消任务
39. // task.waitUntilFinished(); // 可以等待任务完成

简单上传二进制byte[]数组

1. byte[] uploadData = new byte[100 * 1024];
2. new Random().nextBytes(uploadData);
4. // 构造上传请求
5. PutObjectRequest put = new PutObjectRequest(testBucket, testObject, uploadData);
7. try {
8.     PutObjectResult putResult = oss.putObject(put);
10.     Log.d("PutObject", "UploadSuccess");
12.     Log.d("ETag", putResult.getETag());
13.     Log.d("RequestId", putResult.getRequestId());
14. } catch (ClientException e) {
15.     // 本地异常如网络异常等
16.     e.printStackTrace();
17. } catch (ServiceException e) {
18.     // 服务异常
19.     Log.e("RequestId", e.getRequestId());
20.     Log.e("ErrorCode", e.getErrorCode());
21.     Log.e("HostId", e.getHostId());
22.     Log.e("RawMessage", e.getRawMessage());
23. }

上传到文件目录


OSS服务是没有文件夹这个概念的，所有元素都是以文件来存储，但给用户提供了创建模拟文件夹的方式。创建模拟文件夹本质上来说是创建了一个名字以“/”结尾的文件，这个文件可以上传下载，只是控制台会对以“/”结尾的文件以文件夹的方式展示。
在上传文件时，如果把ObjectKey写为"folder/subfolder/file"，即是模拟了把文件上传到folder/subfolder/下的file文件。

注意：OSS路径默认是”根目录”，不需要以’/‘开头。

上传Content-Type设置


在Web服务中Content-Type用来设定文件的类型，决定以什么形式、什么编码读取这个文件。某些情况下，对于上传的文件需要设定Content-Type，否则文件不能以自己需要的形式和编码来读取。使用SDK上传文件时，如果不指定Content-Type，SDK会帮您根据后缀自动添加Content-Type。

1. // 构造上传请求
2. PutObjectRequest put = new PutObjectRequest("<bucketName>", "<objectKey>", "<uploadFilePath>");
4. ObjectMetadata metadata = new ObjectMetadata();
5. // 指定Content-Type
6. metadata.setContentType("application/octet-stream");
7. // user自定义metadata
8. metadata.addUserMetadata("x-oss-meta-name1", "value1");
9. put.setMetadata(metadata);
11. OSSAsyncTask task = oss.asyncPutObject(put, new OSSCompletedCallback<PutObjectRequest, PutObjectResult>() {
12.     ...
13. });

MD5校验设置


如果要校验上传到OSS的文件和本地文件是否一致，可以在上传文件时携带文件的Content-MD5值，OSS服务器会帮助用户进行MD5校验，只有在OSS服务器接收到的文件MD5值和Content-MD5一致时才可以上传成功，从而保证上传数据的一致性。

1. // 构造上传请求
2. PutObjectRequest put = new PutObjectRequest("<bucketName>", "<objectKey>", "<uploadFilePath>");
4. ObjectMetadata metadata = new ObjectMetadata();
5. metadata.setContentType("application/octet-stream");
6. try {
7.     // 设置Md5以便校验
8.     metadata.setContentMD5(BinaryUtil.calculateBase64Md5("<uploadFilePath>")); // 如果是从文件上传
9.     // metadata.setContentMD5(BinaryUtil.calculateBase64Md5(byte[])); // 如果是上传二进制数据
10. } catch (IOException e) {
11.     e.printStackTrace();
12. }
13. put.setMetadata(metadata);
15. OSSAsyncTask task = oss.asyncPutObject(put, new OSSCompletedCallback<PutObjectRequest, PutObjectResult>() {
16.     ...
17. });