com.amazonaws.services.s3.model

Class UploadObjectRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.s3.model.AbstractPutObjectRequest

com.amazonaws.services.s3.model.UploadObjectRequest

All Implemented Interfaces:

S3DataSource, SSEAwsKeyManagementParamsProvider, SSECustomerKeyProvider, Cloneable

public class UploadObjectRequest
extends AbstractPutObjectRequest

Used to request the client-side encryption and upload of a large S3 object via pipelined parallel multi-part uploads.

See Also:

AmazonS3EncryptionClient.uploadObject(UploadObjectRequest)

Nested Class Summary

Nested classes/interfaces inherited from interface com.amazonaws.services.s3.model.S3DataSource

S3DataSource.Utils

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
UploadObjectRequest(String bucketName, String key, File file)
UploadObjectRequest(String bucketName, String key, InputStream input, ObjectMetadata metadata)

Method Summary

Methods

Modifier and Type	Method and Description
UploadObjectRequest	clone() Returns a clone (as deep as possible) of this request object.
long	getDiskLimit() Returns the maximum size (in bytes) of additional disk space that will be consumed for this request; or Long.MAX_VALUE if there is no limit.
ExecutorService	getExecutorService() Returns a custom executor service for concurrent uploads; or null there is no customization.
com.amazonaws.services.s3.internal.MultiFileOutputStream	getMultiFileOutputStream() Returns a custom multi-file output stream; or null if the default is to be used.
long	getPartSize() Returns the part-size used for muti-part upload for this request.
UploadObjectObserver	getUploadObjectObserver() Returns a custom upload-object observer; or null there is no customization.
UploadObjectRequest	withDiskLimit(long diskLimit) Configured the maximum disk space (in bytes) that will be consumed for this request.
UploadObjectRequest	withExecutorService(ExecutorService executorService) Configure a custom executor service for concurrent uploads.
UploadObjectRequest	withMultiFileOutputStream(com.amazonaws.services.s3.internal.MultiFileOutputStream multiFileOutputStream) Configure a custom multi-file output stream; or null if the default is to be used.
UploadObjectRequest	withPartSize(long partSize) Configured the part size for multi-part upload.
UploadObjectRequest	withUploadObjectObserver(UploadObjectObserver uploadObjectObserver) Configure a custom upload-object observer; or null if the default is to be used.

Methods inherited from class com.amazonaws.services.s3.model.AbstractPutObjectRequest

getAccessControlList, getBucketName, getCannedAcl, getFile, getInputStream, getKey, getMetadata, getProgressListener, getRedirectLocation, getSSEAwsKeyManagementParams, getSSECustomerKey, getStorageClass, setAccessControlList, setBucketName, setCannedAcl, setFile, setInputStream, setKey, setMetadata, setProgressListener, setRedirectLocation, setSSEAwsKeyManagementParams, setSSECustomerKey, setStorageClass, setStorageClass, withAccessControlList, withBucketName, withCannedAcl, withFile, withInputStream, withKey, withMetadata, withProgressListener, withRedirectLocation, withSSEAwsKeyManagementParams, withSSECustomerKey, withStorageClass, withStorageClass

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyBaseTo, copyPrivateRequestParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

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

Constructor Detail

UploadObjectRequest

public UploadObjectRequest(String bucketName,
                   String key,
                   File file)

UploadObjectRequest

public UploadObjectRequest(String bucketName,
                   String key,
                   InputStream input,
                   ObjectMetadata metadata)

Method Detail

clone

public UploadObjectRequest clone()

Returns a clone (as deep as possible) of this request object.

Specified by:

clone in class AbstractPutObjectRequest

getPartSize

public long getPartSize()

Returns the part-size used for muti-part upload for this request. This part size will be used as a reference for the multi-part uploads but the physical part size may vary.

withPartSize

public UploadObjectRequest withPartSize(long partSize)

Configured the part size for multi-part upload. Must be at least MIN_PART_SIZE. This part size will be used as a reference for the multi-part uploads but the physical part size may vary.

Returns:

this object for method chaining purposes

getDiskLimit

public long getDiskLimit()

Returns the maximum size (in bytes) of additional disk space that will be consumed for this request; or Long.MAX_VALUE if there is no limit.

withDiskLimit

public UploadObjectRequest withDiskLimit(long diskLimit)

Configured the maximum disk space (in bytes) that will be consumed for this request. The maximum disk space must be at least twice the size of partSize.

Returns:

this object for method chaining purposes

getExecutorService

public ExecutorService getExecutorService()

Returns a custom executor service for concurrent uploads; or null there is no customization.

withExecutorService

public UploadObjectRequest withExecutorService(ExecutorService executorService)

Configure a custom executor service for concurrent uploads.

Returns:

this object for method chaining purposes

getMultiFileOutputStream

public com.amazonaws.services.s3.internal.MultiFileOutputStream getMultiFileOutputStream()

Returns a custom multi-file output stream; or null if the default is to be used.

withMultiFileOutputStream

public UploadObjectRequest withMultiFileOutputStream(com.amazonaws.services.s3.internal.MultiFileOutputStream multiFileOutputStream)

Configure a custom multi-file output stream; or null if the default is to be used.

Returns:

this object for method chaining purposes

getUploadObjectObserver

public UploadObjectObserver getUploadObjectObserver()

Returns a custom upload-object observer; or null there is no customization.

withUploadObjectObserver

public UploadObjectRequest withUploadObjectObserver(UploadObjectObserver uploadObjectObserver)

Configure a custom upload-object observer; or null if the default is to be used.

Returns:

this object for method chaining purposes