Class LargeFileUploaderResumeContext


  • public class LargeFileUploaderResumeContext
    extends java.lang.Object
    Used to resume an existing incomplete MPU.

    You *must* provide an uploadId to resume. All parts provided in uploadedParts are trusted and assumed to be already verified. If you do not provide a map of uploadedParts, the MPU uploadId parts will be listed. In this case, the listed parts will *not* be trusted. All parts in the list will be sanity checked, and re-read from the source data to create an accurate part ETag manifest and verify all object data as per S3 best practices. If you do not wish to re-verify existing parts found in the target, you can set verifyPartsFoundInTarget to false (not recommended).

    • Constructor Detail

      • LargeFileUploaderResumeContext

        public LargeFileUploaderResumeContext()
    • Method Detail

      • getUploadId

        public java.lang.String getUploadId()
      • setUploadId

        public void setUploadId​(java.lang.String uploadId)
        Specifies the specific upload ID to resume. This is required to resume an MPU.
      • getUploadedParts

        public java.util.Map<java.lang.Integer,​MultipartPartETag> getUploadedParts()
      • setUploadedParts

        public void setUploadedParts​(java.util.Map<java.lang.Integer,​MultipartPartETag> uploadedParts)
        Specifies a map of existing parts to skip. If a part list is provided here, it is trusted, and used in the final part ETag manifest. If this is not specified, the configured uploadId will be listed to identify parts to skip. However, that list will *not* be trusted, so all part sizes/count will be verified as a sanity check, and the part ranges will be re-read from the source to create an accurate part ETag manifest and verify all object data.
      • isVerifyPartsFoundInTarget

        public boolean isVerifyPartsFoundInTarget()
      • setVerifyPartsFoundInTarget

        public void setVerifyPartsFoundInTarget​(boolean verifyPartsFoundInTarget)
        If uploadedParts is *not* provided, and existing parts are found in the target, this flag will re-read the source part ranges, to create a valid part ETag manifest and verify the entire dataset of the object. Default is true
      • isOverwriteMismatchedParts

        public boolean isOverwriteMismatchedParts()
      • setOverwriteMismatchedParts

        public void setOverwriteMismatchedParts​(boolean overwriteMismatchedParts)
        If verifyPartsFoundInTarget is true, and during verification of an existing part, the ETag does not match, that part will be re-uploaded. Default is true