Package cn.herodotus.oss.specification.core.repository

Interface OssMultipartUploadRepository

public interface OssMultipartUploadRepository

Description: Dante Java OSS API 分片操作抽象定义

Author:
: gengwei.zheng
Date:
: 2023/8/12 21:56

  • Method Details

    • initiateMultipartUpload

      default String initiateMultipartUpload(String bucketName, String objectName)
      创建分片上传请求, 返回 UploadId
      Parameters:
      bucketName - 存储桶名称
      objectName - 对象名称
      Returns:
      分片上传唯一 uploadId

    • initiateMultipartUpload

      InitiateMultipartUploadDomain initiateMultipartUpload(InitiateMultipartUploadArguments arguments)
      创建分片上传请求, 返回 UploadId

      启动一个分片上传并返回一个包含 UploadId 的 InitiateMultipartUploadResult。 该UploadId将特定上传中的所有部分关联起来，并在您随后的每个 uploadPart（UploadPartRequest）请求中使用。您还可以在最终请求中包含此UploadId，以完成或中止分片上载请求。

      Parameters:
      arguments - 创建分片上传请求参数实体 InitiateMultipartUploadArguments
      Returns:
      创建分片上传结果 InitiateMultipartUploadDomain

    • uploadPart

      UploadPartDomain uploadPart(UploadPartArguments arguments)
      在分片上传中上传一个部分。必须先启动分片上传，然后才能上传任何部分。

      您的 UploadPart请求必须包括上传 ID、分片号和分片尺寸。上传ID是Amazon S3在响应您的Initiate Multipart upload请求时返回的ID。 分片号可以是介于1和10000之间的任何数字，包括1和10000。分片号唯一标识分片，还定义其在上载对象中的位置。如果使用与上载上一个分片时指定的分片号相同的分片号上载新分片，则会覆盖先前上载的分片

      Parameters:
      arguments - 部分上传请求参数实体 UploadPartArguments
      Returns:
      部分上传复制结果域对象 UploadPartDomain

    • uploadPartCopy

      UploadPartCopyDomain uploadPartCopy(UploadPartCopyArguments arguments)
      将源对象复制到分片上传的一部分
      Parameters:
      arguments - 部分上传复制请求参数实体 UploadPartCopyArguments
      Returns:
      部分上传复制结果域对象 InitiateMultipartUploadDomain

    • completeMultipartUpload

      default CompleteMultipartUploadDomain completeMultipartUpload(String bucketName, String objectName, String uploadId, List<PartSummaryDomain> parts)
      通过组装以前上传的部分来完成分片上传
      Parameters:
      bucketName - 存储桶名称
      objectName - 对象名称
      uploadId - 上传ID
      parts - 所有上传分片
      Returns:
      完成分片上传域对象 CompleteMultipartUploadDomain

    • completeMultipartUpload

      CompleteMultipartUploadDomain completeMultipartUpload(CompleteMultipartUploadArguments arguments)
      通过组装以前上传的部分来完成分片上传。
      Parameters:
      arguments - 完成分片上传请求参数实体 CompleteMultipartUploadArguments
      Returns:
      完成分片上传域对象 CompleteMultipartUploadDomain

    • abortMultipartUpload

      AbortMultipartUploadDomain abortMultipartUpload(AbortMultipartUploadArguments arguments)
      中止分片上载。中止分片上传后，无法使用该上传ID上传任何其他部分。之前上传的任何部分所消耗的存储空间都将被释放。但是，如果当前正在进行任何分片上载，则这些分片上载可能成功，也可能不成功。因此，可能需要多次中止给定的分片上传，以便完全释放所有部分消耗的所有存储。
      Parameters:
      arguments - 完成分片上传请求参数实体 AbortMultipartUploadArguments
      Returns:
      完成分片上传域对象 AbortMultipartUploadDomain

    • listParts

      default ListPartsDomain listParts(String bucketName, String objectName, String uploadId)
      获取分片列表
      Parameters:
      bucketName - 存储桶名称
      objectName - 对象名称
      uploadId - 上传ID
      Returns:
      分片列表结果 ListPartsDomain

    • listParts

      ListPartsDomain listParts(ListPartsArguments arguments)
      获取分片列表
      Parameters:
      arguments - 获取分片列表请求参数实体 ListPartsArguments
      Returns:
      分片列表结果 ListPartsDomain

    • listMultipartUploads

      ListMultipartUploadsDomain listMultipartUploads(ListMultipartUploadsArguments arguments)
      列出正在进行的分片上传。进行中的分片上传是指已使用InitiateMultipartUpload请求启动但尚未完成或中止的分片上传

      默认情况下，此操作在响应中最多返回1000个分片上传。可以使用请求参数上的MaxUploads属性进一步限制分片上传的数量。 如果有其他满足列表条件的分片上传，则响应将包含一个值设置为true的IsTruncated属性。要列出额外的分片上传，请在请求参数上使用KeyMarker和UploadIdMarker属性。

      Parameters:
      arguments - 列出正在进行的分片上传请求参数实体 ListMultipartUploadsArguments
      Returns:
      列出正在进行的分片上传结果 ListMultipartUploadsDomain