C-SDK之如何实现上传文件(一)?

在OSS中，用户操作的基本数据单元是文件(Object)。单个文件的最大允许大小根据上传数据方式不同而不同，Put Object方式文件最大不能超过5GB，使用分片上传方式文件大小不能超过48.8TB。
OSS C SDK提供了丰富的文件上传接口，用户可以通过以下方式向OSS中上传文件：

• 简单上传
• 追加上传
• 断点续传上传
• 分片上传

1. [backcolor=transparent]void[backcolor=transparent] put_object_from_buffer[backcolor=transparent]()
2. [backcolor=transparent]{
3. [backcolor=transparent]    [backcolor=transparent]aos_pool_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]p [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
4. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] bucket[backcolor=transparent];
5. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] object[backcolor=transparent];
6. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]headers [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
7. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]resp_headers [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
8. [backcolor=transparent]    [backcolor=transparent]oss_request_options_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]options [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
9. [backcolor=transparent]    [backcolor=transparent]aos_list_t[backcolor=transparent] buffer[backcolor=transparent];
10. [backcolor=transparent]    [backcolor=transparent]aos_buf_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]content [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
11. [backcolor=transparent]    [backcolor=transparent]char[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]str [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"test oss c sdk"[backcolor=transparent];
12. [backcolor=transparent]    [backcolor=transparent]aos_status_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]s [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
14. [backcolor=transparent]    aos_pool_create[backcolor=transparent](&[backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] NULL[backcolor=transparent]);
16. [backcolor=transparent]    [backcolor=transparent]/* 创建并初始化options */
17. [backcolor=transparent]    options [backcolor=transparent]=[backcolor=transparent] oss_request_options_create[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
18. [backcolor=transparent]    init_options[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent]);
19. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的bucket名字>"[backcolor=transparent]);
20. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的object名字>"[backcolor=transparent]);
22. [backcolor=transparent]    [backcolor=transparent]/* 初始化参数 */
23. [backcolor=transparent]    aos_list_init[backcolor=transparent](&[backcolor=transparent]buffer[backcolor=transparent]);
24. [backcolor=transparent]    content [backcolor=transparent]=[backcolor=transparent] aos_buf_pack[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent]->[backcolor=transparent]pool[backcolor=transparent],[backcolor=transparent] str[backcolor=transparent],[backcolor=transparent] strlen[backcolor=transparent]([backcolor=transparent]str[backcolor=transparent]));
25. [backcolor=transparent]    aos_list_add_tail[backcolor=transparent](&[backcolor=transparent]content[backcolor=transparent]->[backcolor=transparent]node[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]buffer[backcolor=transparent]);
27. [backcolor=transparent]    [backcolor=transparent]/* 上传文件 */
28. [backcolor=transparent]    s [backcolor=transparent]=[backcolor=transparent] oss_put_object_from_buffer[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent]
29. [backcolor=transparent]                   [backcolor=transparent]&[backcolor=transparent]buffer[backcolor=transparent],[backcolor=transparent] headers[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]resp_headers[backcolor=transparent]);
31. [backcolor=transparent]    [backcolor=transparent]/* 判断是否上传成功 */
32. [backcolor=transparent]    [backcolor=transparent]if[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]aos_status_is_ok[backcolor=transparent]([backcolor=transparent]s[backcolor=transparent]))[backcolor=transparent] [backcolor=transparent]{
33. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"put object from buffer succeeded\n"[backcolor=transparent]);
34. [backcolor=transparent]    [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]else[backcolor=transparent] [backcolor=transparent]{
35. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"put object from buffer failed\n"[backcolor=transparent]);[backcolor=transparent]      
36. [backcolor=transparent]    [backcolor=transparent]}[backcolor=transparent]    
38. [backcolor=transparent]    [backcolor=transparent]/* 释放资源*/
39. [backcolor=transparent]    aos_pool_destroy[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
40. [backcolor=transparent]}

[backcolor=transparent]注：

• 完整代码参考：GitHub

1. [backcolor=transparent]void[backcolor=transparent] put_object_from_file[backcolor=transparent]()
2. [backcolor=transparent]{
3. [backcolor=transparent]    [backcolor=transparent]aos_pool_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]p [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
4. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] bucket[backcolor=transparent];
5. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] object[backcolor=transparent];
6. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]headers [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
7. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]resp_headers [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
8. [backcolor=transparent]    [backcolor=transparent]oss_request_options_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]options [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
9. [backcolor=transparent]    [backcolor=transparent]char[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]filename [backcolor=transparent]=[backcolor=transparent] __FILE__[backcolor=transparent];
10. [backcolor=transparent]    [backcolor=transparent]aos_status_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]s [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
11. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] file[backcolor=transparent];
13. [backcolor=transparent]    aos_pool_create[backcolor=transparent](&[backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] NULL[backcolor=transparent]);
15. [backcolor=transparent]    [backcolor=transparent]/* 创建并初始化options */
16. [backcolor=transparent]    options [backcolor=transparent]=[backcolor=transparent] oss_request_options_create[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
17. [backcolor=transparent]    init_options[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent]);
19. [backcolor=transparent]    [backcolor=transparent]/* 初始化参数 */
20. [backcolor=transparent]    headers [backcolor=transparent]=[backcolor=transparent] aos_table_make[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent]->[backcolor=transparent]pool[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]1[backcolor=transparent]);
21. [backcolor=transparent]    apr_table_set[backcolor=transparent]([backcolor=transparent]headers[backcolor=transparent],[backcolor=transparent] OSS_CONTENT_TYPE[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"image/jpeg"[backcolor=transparent]);
22. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的bucket名字>"[backcolor=transparent]);
23. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的object名字>"[backcolor=transparent]);
24. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]file[backcolor=transparent],[backcolor=transparent] filename[backcolor=transparent]);
26. [backcolor=transparent]    [backcolor=transparent]/* 上传文件 */
27. [backcolor=transparent]    s [backcolor=transparent]=[backcolor=transparent] oss_put_object_from_file[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]file[backcolor=transparent],[backcolor=transparent]
28. [backcolor=transparent]                                 headers[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]resp_headers[backcolor=transparent]);
30. [backcolor=transparent]    [backcolor=transparent]/* 判断是否上传成功 */
31. [backcolor=transparent]    [backcolor=transparent]if[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]aos_status_is_ok[backcolor=transparent]([backcolor=transparent]s[backcolor=transparent]))[backcolor=transparent] [backcolor=transparent]{
32. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"put object from file succeeded\n"[backcolor=transparent]);
33. [backcolor=transparent]    [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]else[backcolor=transparent] [backcolor=transparent]{
34. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"put object from file failed\n"[backcolor=transparent]);
35. [backcolor=transparent]    [backcolor=transparent]}
37. [backcolor=transparent]    [backcolor=transparent]/* 释放资源*/
38. [backcolor=transparent]    aos_pool_destroy[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
39. [backcolor=transparent]}

[backcolor=transparent]注：

• 使用该方式上传最大文件不能超过5G。如果超过可以使用分片上传。
• 完整代码参考：GitHub

• 文件不存在时，调用Append Object会创建一个可追加的文件
• 文件存在时，调用Append Object会向文件末尾追加内容

1. [backcolor=transparent]void[backcolor=transparent] append_object_from_buffer[backcolor=transparent]()
2. [backcolor=transparent]{
3. [backcolor=transparent]    [backcolor=transparent]aos_pool_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]p [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
4. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] bucket[backcolor=transparent];
5. [backcolor=transparent]    [backcolor=transparent]aos_string_t[backcolor=transparent] object[backcolor=transparent];
6. [backcolor=transparent]    [backcolor=transparent]char[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]str [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"test oss c sdk"[backcolor=transparent];
7. [backcolor=transparent]    [backcolor=transparent]aos_status_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]s [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
8. [backcolor=transparent]    [backcolor=transparent]int64_t[backcolor=transparent] position [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]0[backcolor=transparent];
9. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]headers1 [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
10. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]headers2 [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
11. [backcolor=transparent]    [backcolor=transparent]aos_table_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]resp_headers [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
12. [backcolor=transparent]    [backcolor=transparent]oss_request_options_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]options [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
13. [backcolor=transparent]    [backcolor=transparent]aos_list_t[backcolor=transparent] buffer[backcolor=transparent];
14. [backcolor=transparent]    [backcolor=transparent]aos_buf_t[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]content [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
15. [backcolor=transparent]    [backcolor=transparent]char[backcolor=transparent] [backcolor=transparent]*[backcolor=transparent]next_append_position [backcolor=transparent]=[backcolor=transparent] NULL[backcolor=transparent];
17. [backcolor=transparent]    aos_pool_create[backcolor=transparent](&[backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] NULL[backcolor=transparent]);
19. [backcolor=transparent]    [backcolor=transparent]/* 创建并初始化options */
20. [backcolor=transparent]    options [backcolor=transparent]=[backcolor=transparent] oss_request_options_create[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
21. [backcolor=transparent]    init_options[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent]);
23. [backcolor=transparent]    [backcolor=transparent]/* 初始化参数 */
24. [backcolor=transparent]    headers1 [backcolor=transparent]=[backcolor=transparent] aos_table_make[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]0[backcolor=transparent]);
25. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的bucket名字>"[backcolor=transparent]);
26. [backcolor=transparent]    aos_str_set[backcolor=transparent](&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]"<您的object名字>"[backcolor=transparent]);
28. [backcolor=transparent]    [backcolor=transparent]/* 获取起始追加位置 */
29. [backcolor=transparent]    s [backcolor=transparent]=[backcolor=transparent] oss_head_object[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent] headers1[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]resp_headers[backcolor=transparent]);
30. [backcolor=transparent]    [backcolor=transparent]if[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]aos_status_is_ok[backcolor=transparent]([backcolor=transparent]s[backcolor=transparent]))[backcolor=transparent] [backcolor=transparent]{
31. [backcolor=transparent]        next_append_position [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]char[backcolor=transparent]*)([backcolor=transparent]apr_table_get[backcolor=transparent]([backcolor=transparent]resp_headers[backcolor=transparent],[backcolor=transparent]
32. [backcolor=transparent]                        [backcolor=transparent]"x-oss-next-append-position"[backcolor=transparent]));
33. [backcolor=transparent]        position [backcolor=transparent]=[backcolor=transparent] atoi[backcolor=transparent]([backcolor=transparent]next_append_position[backcolor=transparent]);
34. [backcolor=transparent]    [backcolor=transparent]}
36. [backcolor=transparent]    [backcolor=transparent]/* 追加文件 */
37. [backcolor=transparent]    headers2 [backcolor=transparent]=[backcolor=transparent] aos_table_make[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]0[backcolor=transparent]);
38. [backcolor=transparent]    aos_list_init[backcolor=transparent](&[backcolor=transparent]buffer[backcolor=transparent]);
39. [backcolor=transparent]    content [backcolor=transparent]=[backcolor=transparent] aos_buf_pack[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent],[backcolor=transparent] str[backcolor=transparent],[backcolor=transparent] strlen[backcolor=transparent]([backcolor=transparent]str[backcolor=transparent]));
40. [backcolor=transparent]    aos_list_add_tail[backcolor=transparent](&[backcolor=transparent]content[backcolor=transparent]->[backcolor=transparent]node[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]buffer[backcolor=transparent]);
41. [backcolor=transparent]    s [backcolor=transparent]=[backcolor=transparent] oss_append_object_from_buffer[backcolor=transparent]([backcolor=transparent]options[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]bucket[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]object[backcolor=transparent],[backcolor=transparent]
42. [backcolor=transparent]            position[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]buffer[backcolor=transparent],[backcolor=transparent] headers2[backcolor=transparent],[backcolor=transparent] [backcolor=transparent]&[backcolor=transparent]resp_headers[backcolor=transparent]);
44. [backcolor=transparent]    [backcolor=transparent]/* 判断是否追加成功 */
45. [backcolor=transparent]    [backcolor=transparent]if[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]aos_status_is_ok[backcolor=transparent]([backcolor=transparent]s[backcolor=transparent]))
46. [backcolor=transparent]    [backcolor=transparent]{
47. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"append object from buffer succeeded\n"[backcolor=transparent]);
48. [backcolor=transparent]    [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]else[backcolor=transparent] [backcolor=transparent]{
49. [backcolor=transparent]        printf[backcolor=transparent]([backcolor=transparent]"append object from buffer failed\n"[backcolor=transparent]);
50. [backcolor=transparent]    [backcolor=transparent]}
52. [backcolor=transparent]    [backcolor=transparent]/* 释放资源*/
53. [backcolor=transparent]    aos_pool_destroy[backcolor=transparent]([backcolor=transparent]p[backcolor=transparent]);
54. [backcolor=transparent]}

[backcolor=transparent]注：

• 完整代码参考：GitHub