Package com.qiniu.storage

Class ApiUploadV2CompleteUpload

java.lang.Object

com.qiniu.storage.Api

com.qiniu.storage.ApiUpload

com.qiniu.storage.ApiUploadV2CompleteUpload

public class ApiUploadV2CompleteUpload
extends ApiUpload

分片上传 v2 版 api: 完成文件上传 在将所有数据 Part 都上传完成后，必须调用 ApiUploadV2CompleteUpload API 来完成整个文件的 Multipart Upload。用户需要提供有效数据的 Part 列表（ 包括 PartNumber 和调用 uploadPart API 服务端返回的 Etag ）。服务端收到用户提交的 Part 列表后，会逐一验证每个数据 Part 的有效性。当所有的数据 Part 验证通过后，会把这些数据 Part 组合成一个完整的 Object。

一个文件被分成多个 part，上传所有的 part，然后在七牛云根据 part 信息合成文件 |----------------------------- file -----------------------------| |------ part ------|------ part ------|------ part ------|... |----- etag01 -----|----- etag02 -----|----- etag03 -----|... allBlockCtx = [{"partNumber":1, "etag", etag01}, {"partNumber":2, "etag", etag02}, {"partNumber":3, "etag", etag03}, ...]

上传过程： 1. 调用 ApiUploadV2InitUpload api 创建一个 upload 任务，获取 uploadId ApiUploadV2InitUpload.Response.getUploadId() 2. 重复调用 ApiUploadV2UploadPart api 直到文件所有的 part 均上传完毕, part 的大小可以不相同 3. 调用 ApiUploadV2CompleteUpload api 组装 api 选用接口： 1. ApiUploadV2ListParts 列举已上传的 part 信息 2. ApiUploadV2AbortUpload 终止上传

注意事项： 1. partNumber 范围是 1 ~ 10000 2. 除最后一个 Part 外，单个 Part 大小范围 1 MB ~ 1 GB 3. 如果你用同一个 PartNumber 上传了新的数据，那么服务端已有的这个号码的 Part 数据将被覆盖 4. ApiUploadV2InitUpload、ApiUploadV2UploadPart、ApiUploadV2CompleteUpload、ApiUploadV2ListParts、 ApiUploadV2AbortUpload 分片 V2 API的 key 需要统一（要么有设置且相同，要么均不设置）

https://developer.qiniu.com/kodo/6368/complete-multipart-upload

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ApiUploadV2CompleteUpload.Request	请求信息
static class	ApiUploadV2CompleteUpload.Response	响应信息

Constructor Summary

Constructors

Constructor	Description
ApiUploadV2CompleteUpload(Client client)	api 构建函数

Method Summary

Modifier and Type	Method	Description
ApiUploadV2CompleteUpload.Response	request(ApiUploadV2CompleteUpload.Request request)	发起请求

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ApiUploadV2CompleteUpload

public ApiUploadV2CompleteUpload(Client client)

api 构建函数

Parameters:

client - 请求client 【必须】

Method Detail

request

public ApiUploadV2CompleteUpload.Response request(ApiUploadV2CompleteUpload.Request request)
                                           throws QiniuException

发起请求

Parameters:

request - 请求对象 【必须】

Returns:

响应对象

Throws:

QiniuException - 请求异常