Package com.qiniu.storage

Class ApiUploadV2CompleteUpload.Request

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String PART_ETG  
      static java.lang.String PART_NUMBER  

    • Constructor Summary

      Constructors 
      Constructor Description
      Request​(java.lang.String urlPrefix, java.lang.String token, java.lang.String uploadId, java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> partsInfo)
      请求构造函数

    • Constructor Detail

      • Request

        public Request​(java.lang.String urlPrefix,
               java.lang.String token,
               java.lang.String uploadId,
               java.util.List<java.util.Map<java.lang.String,​java.lang.Object>> partsInfo)
        请求构造函数
        Parameters:
        urlPrefix - 请求 scheme + host 【必须】 host 参考: https://developer.qiniu.com/kodo/1671/region-endpoint-fq 注意事项： 1. token 中签名的 bucket 所在机房必须和 host 的机房一致 2. 如果不能提前知道机房信息，可调用 ApiQueryRegion api 获取 region 上传 Hosts
        token - 请求凭证 【必须】
        uploadId - 在服务端申请的 MultipartUpload 任务 id; 服务端处理 completeMultipartUpload 请求成功后，该 UploadId 就会变成无效，再次请求与该 UploadId 相关操作都会失败。【必须】
        partsInfo - 已经上传 Part 列表【必须】 包括 PartNumber(int) 和调用 uploadPart API 服务端返回的 Etag(string) eg：[{ "etag": "[Etag]", "partNumber": [PartNumber] }, ...] 注意事项： 1. 每一个上传的 Part 都有一个标识它的号码 PartNumber，范围是 1 - 10000，单个 Part大小范围 1 MB - 1 GB。 Multipart Upload 要求除最后一个 Part 以外，其他的 Part 大小都要大于等于 1 MB。因不确定是否为最后一个 Part， uploadPart API 并不会立即校验上传 Part 的大小，当 completeMultipartUpload API 调用的时候才会校验。 2. 如果你用同一个 PartNumber 上传了新的数据，那么服务端已有的这个号码的 Part 数据将被覆盖。 3. 用户提交的 Part 列表中，Part 号码可以不连续，但必须是升序;

    • Method Detail

      • setKey

        public ApiUploadV2CompleteUpload.Request setKey​(java.lang.String key)
        设置资源在七牛云保存的名称【可选】 若未指定，则使用saveKey；若未指定 saveKey，则使用资源内容的 SHA1 值作为资源名。
        Parameters:
        key - 保存的名称
        Returns:
        Request

      • setFileName

        public ApiUploadV2CompleteUpload.Request setFileName​(java.lang.String fileName)
        设置资源的文件名【可选】 若未指定，则魔法变量中无法使用fname, ext, fprefix。
        Parameters:
        fileName - 保存的名称
        Returns:
        Request

      • setFileMimeType

        public ApiUploadV2CompleteUpload.Request setFileMimeType​(java.lang.String fileMimeType)
        设置资源的类型【可选】 若未指定，则根据文件内容自动检测 mimeType。
        Parameters:
        fileMimeType - 资源的类型
        Returns:
        Request

      • setCustomParam

        public ApiUploadV2CompleteUpload.Request setCustomParam​(java.util.Map<java.lang.String,​java.lang.Object> params)
        自定义变量【可选】 CustomVarKey 和 CustomVarValue 都是 string 注：CustomVarKey 必须增加前缀 x:, 如 {"x:foo", "foo"}, SDK 内部不会检查 key 的格式 https://developer.qiniu.com/kodo/1235/vars
        Parameters:
        params - 自定义变量
        Returns:
        Request

      • setCustomMetaParam

        public ApiUploadV2CompleteUpload.Request setCustomMetaParam​(java.util.Map<java.lang.String,​java.lang.Object> params)
        用户自定义文件 metadata 信息的 key 和 value 【可选】 可以设置多个，MetaKey 和 MetaValue 都是 string，其中 可以由字母、数字、 下划线、减号组成，且长度小于等于 50，单个文件 MetaKey 和 Metavalue 总和大小不能超过 1024 字节 注：自定义 meta data 的 key 需要增加前缀 x-qn-meta-, 如 {"x-qn-meta-key", "foo"}, SDK 内部不会检查 key 的格式
        Parameters:
        params - meta data
        Returns:
        Request