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

简单上传


上传Object可以直接上传OSSData，或者通过NSURL上传一个文件：

1. OSSPutObjectRequest * put = [OSSPutObjectRequest new];
3. // 必填字段
4. put.bucketName = @"<bucketName>";
5. put.objectKey = @"<objectKey>";
7. put.uploadingFileURL = [NSURL fileURLWithPath:@"<filepath>"];
8. // put.uploadingData = <NSData *>; // 直接上传NSData
10. // 可选字段，可不设置
11. put.uploadProgress = ^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
12.     // 当前上传段长度、当前已经上传总长度、一共需要上传的总长度
13.     NSLog(@"%lld, %lld, %lld", bytesSent, totalByteSent, totalBytesExpectedToSend);
14. };
16. // 以下可选字段的含义参考： https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObject
17. // put.contentType = @"";
18. // put.contentMd5 = @"";
19. // put.contentEncoding = @"";
20. // put.contentDisposition = @"";
22. // put.objectMeta = [NSMutableDictionary dictionaryWithObjectsAndKeys:@"value1", @"x-oss-meta-name1", nil]; // 可以在上传时设置元信息或者其他HTTP头部
24. OSSTask * putTask = [client putObject:put];
26. [putTask continueWithBlock:^id(OSSTask *task) {
27.     if (!task.error) {
28.         NSLog(@"upload object success!");
29.     } else {
30.         NSLog(@"upload object failed, error: %@" , task.error);
31.     }
32.     return nil;
33. }];
35. // [putTask waitUntilFinished];
37. // [put cancel];

上传到文件目录


OSS服务是没有文件夹这个概念的，所有元素都是以文件来存储，但给用户提供了创建模拟文件夹的方式。创建模拟文件夹本质上来说是创建了一个名字以“/”结尾的文件，对于这个文件照样可以上传下载,只是控制台会对以“/”结尾的文件以文件夹的方式展示。
如，在上传文件是，如果把ObjectKey写为"folder/subfolder/file"，即是模拟了把文件上传到folder/subfolder/下的file文件。注意，路径默认是”根目录”，不需要以’/‘开头。

上传时设置Content-Type和开启校验MD5


上传时可以显式指定ContentType，如果没有指定，SDK会根据文件名或者上传的ObjectKey自动判断。另外，上传Object时如果设置了Content-Md5，那么OSS会用之检查消息内容是否与发送时一致。SDK提供了方便的Base64和MD5计算方法。

1. OSSPutObjectRequest * put = [OSSPutObjectRequest new];
3. // 必填字段
4. put.bucketName = @"<bucketName>";
5. put.objectKey = @"<objectKey>";
7. put.uploadingFileURL = [NSURL fileURLWithPath:@"<filepath>"];
8. // put.uploadingData = <NSData *>; // 直接上传NSData
10. // 设置Content-Type，可选
11. put.contentType = @"application/octet-stream";
13. // 设置MD5校验，可选
14. put.contentMd5 = [OSSUtil base64Md5ForFilePath:@"<filePath>"]; // 如果是文件路径
15. // put.contentMd5 = [OSSUtil base64Md5ForData:<NSData *>]; // 如果是二进制数据
17. // 进度设置，可选
18. put.uploadProgress = ^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
19.     // 当前上传段长度、当前已经上传总长度、一共需要上传的总长度
20.     NSLog(@"%lld, %lld, %lld", bytesSent, totalByteSent, totalBytesExpectedToSend);
21. };
23. OSSTask * putTask = [client putObject:put];
25. [putTask continueWithBlock:^id(OSSTask *task) {
26.     if (!task.error) {
27.         NSLog(@"upload object success!");
28.     } else {
29.         NSLog(@"upload object failed, error: %@" , task.error);
30.     }
31.     return nil;
32. }];
34. // [putTask waitUntilFinished];
36. // [put cancel];

追加上传


Append Object以追加写的方式上传文件。通过Append Object操作创建的Object类型为Appendable Object，而通过Put Object上传的Object是Normal Object。

1. OSSAppendObjectRequest * append = [OSSAppendObjectRequest new];
3. // 必填字段
4. append.bucketName = @"<bucketName>";
5. append.objectKey = @"<objectKey>";
6. append.appendPosition = 0; // 指定从何处进行追加
7. NSString * docDir = [self getDocumentDirectory];
8. append.uploadingFileURL = [NSURL fileURLWithPath:@"<filepath>"];
10. // 可选字段
11. append.uploadProgress = ^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
12.     NSLog(@"%lld, %lld, %lld", bytesSent, totalByteSent, totalBytesExpectedToSend);
13. };
15. // 以下可选字段的含义参考：https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject
16. // append.contentType = @"";
17. // append.contentMd5 = @"";
18. // append.contentEncoding = @"";
19. // append.contentDisposition = @"";
21. OSSTask * appendTask = [client appendObject:append];
23. [appendTask continueWithBlock:^id(OSSTask *task) {
24.     NSLog(@"objectKey: %@", append.objectKey);
25.     if (!task.error) {
26.         NSLog(@"append object success!");
27.         OSSAppendObjectResult * result = task.result;
28.         NSString * etag = result.eTag;
29.         long nextPosition = result.xOssNextAppendPosition;
30.     } else {
31.         NSLog(@"append object failed, error: %@" , task.error);
32.     }
33.     return nil;
34. }];