com.emc.object.s3.lfu

Class LargeFileUploaderResumeContext

java.lang.Object

com.emc.object.s3.lfu.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 Summary

Constructors

Constructor and Description
LargeFileUploaderResumeContext()

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.Integer,MultipartPartETag>	getUploadedParts()
java.lang.String	getUploadId()
boolean	isOverwriteMismatchedParts()
boolean	isVerifyPartsFoundInTarget()
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.
void	setUploadedParts(java.util.Map<java.lang.Integer,MultipartPartETag> uploadedParts) Specifies a map of existing parts to skip.
void	setUploadId(java.lang.String uploadId) Specifies the specific upload ID to resume.
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.
LargeFileUploaderResumeContext	withOverwriteMismatchedParts(boolean overwriteMismatchedParts)
LargeFileUploaderResumeContext	withUploadedParts(java.util.Map<java.lang.Integer,MultipartPartETag> uploadedParts)
LargeFileUploaderResumeContext	withUploadId(java.lang.String uploadId)
LargeFileUploaderResumeContext	withVerifyPartsFoundInTarget(boolean verifyPartsFoundInTarget)

Methods inherited from class java.lang.Object

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

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

withUploadId

public LargeFileUploaderResumeContext withUploadId(java.lang.String uploadId)

See Also:

setUploadId(String)

withUploadedParts

public LargeFileUploaderResumeContext withUploadedParts(java.util.Map<java.lang.Integer,MultipartPartETag> uploadedParts)

See Also:

setUploadedParts(Map)

withVerifyPartsFoundInTarget

public LargeFileUploaderResumeContext withVerifyPartsFoundInTarget(boolean verifyPartsFoundInTarget)

See Also:

setVerifyPartsFoundInTarget(boolean)

withOverwriteMismatchedParts

public LargeFileUploaderResumeContext withOverwriteMismatchedParts(boolean overwriteMismatchedParts)

See Also:

setOverwriteMismatchedParts(boolean)