Package com.qiniu.storage
-
Interface Summary Interface Description Recorder 定义分片上传时纪录上传进度的接口UpCompletionHandler 定义了文件上传结束回调接口 -
Class Summary Class Description Api api 基类Api.Request api 请求基类Api.Response api 响应基类ApiQueryRegion ApiQueryRegion.Request 请求信息ApiQueryRegion.Response 响应信息 dataMap: { "hosts":[ { "region": "z1", "ttl": 86400, "io": { "domains": [ "iovip-z1.qbox.me" ] }, "up": { "domains": [ "upload-z1.qiniup.com", "up-z1.qiniup.com" ], "old": [ "upload-z1.qbox.me", "up-z1.qbox.me"] }, "uc": { "domains": [ "uc.qbox.me" ]}, "rs": { "domains": [ "rs-z1.qbox.me" ] }, "rsf": { "domains": [ "rsf-z1.qbox.me" ] }, "api": { "domains": [ "api-z1.qiniu.com" ] }, "s3": { "domains": [ "s3-cn-north-1.qiniucs.com" ], "region_alias": "cn-north-1" } } ] }ApiUpload ApiUpload.Request upload api 请求基类ApiUpload.Response api 响应基类ApiUploadV1MakeBlock 分片上传 v1 版 api: 创建块 本接口用于为后续分片上传创建一个新的 block,同时上传该块第一个 chunk 数据。ApiUploadV1MakeBlock.Request 请求信息ApiUploadV1MakeBlock.Response 响应信息ApiUploadV1MakeFile 分片上传 v1 版 api: 创建文件 将上传好的所有数据块按指定顺序合并成一个资源文件。ApiUploadV1MakeFile.Request 请求信息ApiUploadV1MakeFile.Response 响应信息ApiUploadV1PutChunk 分片上传 v1 版 api: 上传片 上传指定块的一片数据,具体数据量可根据现场环境调整。同一块的每片数据必须串行上传。ApiUploadV1PutChunk.Request 请求信息ApiUploadV1PutChunk.Response 响应信息ApiUploadV2AbortUpload 分片上传 v2 版 api: 终止上传 该接口根据 UploadId 终止 Multipart Upload 。ApiUploadV2AbortUpload.Request 请求信息ApiUploadV2AbortUpload.Response 响应信息ApiUploadV2CompleteUpload 分片上传 v2 版 api: 完成文件上传 在将所有数据 Part 都上传完成后,必须调用 ApiUploadV2CompleteUpload API 来完成整个文件的 Multipart Upload。用户需要提供有效数据的 Part 列表( 包括 PartNumber 和调用 uploadPart API 服务端返回的 Etag )。服务端收到用户提交的 Part 列表后,会逐一验证每个数据 Part 的有效性。当所有的数据 Part 验证通过后,会把这些数据 Part 组合成一个完整的 Object。ApiUploadV2CompleteUpload.Request 请求信息ApiUploadV2CompleteUpload.Response 响应信息ApiUploadV2InitUpload 分片上传 v2 版 api: 初始化任务 使用 Multipart Upload 方式上传数据前,必须先调用 API 来获取一个全局唯一的 UploadId ,后续的块数据通过 uploadPart API 上传, 整个文件完成 completeMultipartUpload API ,已经上传块的删除 abortMultipartUpload API 都依赖该 UploadId 。ApiUploadV2InitUpload.Request 请求信息ApiUploadV2InitUpload.Response 响应信息ApiUploadV2ListParts 分片上传 v2 版 api: 列举已上传分片信息 API 可列举出指定 UploadId 所属任务所有已经上传成功 Part。ApiUploadV2ListParts.Request 请求信息ApiUploadV2ListParts.Response 响应信息ApiUploadV2UploadPart 分片上传 v2 版 api: 分块上传数据 初始化一个 Multipart Upload 任务之后,可以根据指定的 EncodedObjectName 和 UploadId 来分 Part 上传数据。ApiUploadV2UploadPart.Request 请求信息ApiUploadV2UploadPart.Response 响应信息BaseUploader BucketManager 主要涉及了空间资源管理及批量操作接口的实现,具体的接口规格可以参考 参考文档:资源管理BucketManager.BatchOperations 文件管理批量操作指令构建对象,单次 BatchOperations 的操作数最多为 1000(即 add 最多 1000 个),如果遇到超时,需要调小操作数量ConcurrentResumeUploader 并发分片上传Configuration 该类封装了SDK相关配置参数DownloadPrivateCloudUrl 私有云下载 URL 类DownloadUrl 公有云下载 URL 类FixBlockUploader Deprecated. FixBlockUploader.OptionsMeta FormUploader 该类封装了七牛提供的表单上传机制 参考文档:表单上传Region Region.Builder 域名构造器RegionGroup ResumeUploader 同步分片上传ResumeUploadSourceStream StreamUploader Created by long on 2016/11/4.UploadManager 七牛文件上传管理器,通过该类上传文件时,会自动根据定义的Configuration.putThreshold
来判断是采用表单上传还是分片上传的方法,超过了定义的Configuration.putThreshold
就会采用 分片上传的方法,可以在构造该类对象的时候,通过Configuration
类来自定义这个值。 一般默认可以使用这个类的方法来上传数据和文件。这个类自动检测文件的大小,UploadOptions UploadOptions.Builder -
Enum Summary Enum Description Configuration.ResumableUploadAPIVersion