com.qcloud.cos.model

Class InitiateMultipartUploadRequest

java.lang.Object

com.qcloud.cos.internal.CosServiceRequest

com.qcloud.cos.model.InitiateMultipartUploadRequest

All Implemented Interfaces:

ReadLimitInfo, SSECOSKeyManagementParamsProvider, SSECustomerKeyProvider, Serializable, Cloneable

Direct Known Subclasses:

EncryptedInitiateMultipartUploadRequest

public class InitiateMultipartUploadRequest
extends CosServiceRequest
implements SSECustomerKeyProvider, SSECOSKeyManagementParamsProvider, Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
ObjectMetadata	objectMetadata Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Constructor Summary

Constructors

Constructor and Description
InitiateMultipartUploadRequest(String bucketName, String key) Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key.
InitiateMultipartUploadRequest(String bucketName, String key, long dataSize, long partSize) Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified data size and part size.
InitiateMultipartUploadRequest(String bucketName, String key, ObjectMetadata objectMetadata) Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified object metadata.

Method Summary

Modifier and Type	Method and Description
AccessControlList	getAccessControlList() Returns the optional access control list for the new upload.
String	getBucketName() Returns the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.
CannedAccessControlList	getCannedACL() Returns the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
long	getDataSize()
String	getKey() Returns the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
ObjectMetadata	getObjectMetadata() Returns the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
long	getPartSize()
String	getRedirectLocation() Gets the optional redirect location for the new object.
SSECOSKeyManagementParams	getSSECOSKeyManagementParams() Returns the COS Key Management System parameters used to encrypt the object on server side.
SSECustomerKey	getSSECustomerKey() Returns the optional customer-provided server-side encryption key to use to encrypt the uploaded object.
StorageClass	getStorageClass() Returns the optional storage class to use when storing this upload's data in COS.
void	setAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new upload.
void	setBucketName(String bucketName) Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.
void	setCannedACL(CannedAccessControlList cannedACL) Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
void	setDataSizePartSize(long dataSize, long partSize) Sets the data size and part size of this multipart upload request;
void	setKey(String key) Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
void	setObjectMetadata(ObjectMetadata objectMetadata) Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
void	setRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.
void	setSSECOSKeyManagementParams(SSECOSKeyManagementParams params) Sets the COS Key Management System parameters used to encrypt the object on server side.
void	setSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started.
void	setStorageClass(StorageClass storageClass) Sets the optional storage class to use when storing this upload's data in COS.
InitiateMultipartUploadRequest	withAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new upload.
InitiateMultipartUploadRequest	withBucketName(String bucketName) Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.
InitiateMultipartUploadRequest	withCannedACL(CannedAccessControlList acl) Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.
InitiateMultipartUploadRequest	withDataSizePartSize(long dataSize, long partSize) Sets the data size and part size of this multipart upload request;
InitiateMultipartUploadRequest	withKey(String key) Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.
InitiateMultipartUploadRequest	withObjectMetadata(ObjectMetadata objectMetadata) Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.
InitiateMultipartUploadRequest	withRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.
InitiateMultipartUploadRequest	withSSECOSKeyManagementParams(SSECOSKeyManagementParams sseCOSKeyManagementParams) Sets the COS Key Management System parameters used to encrypt the object on server side.
InitiateMultipartUploadRequest	withSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started, and returns the updated InitiateMultipartUploadRequest so that additional method calls may be chained together.
InitiateMultipartUploadRequest	withStorageClass(StorageClass storageClass) Sets the optional storage class to use when storing this upload's data in COS.
InitiateMultipartUploadRequest	withStorageClass(String storageClass)

Methods inherited from class com.qcloud.cos.internal.CosServiceRequest

clone, copyBaseTo, getCloneRoot, getCloneSource, getCosCredentials, getCustomQueryParameters, getCustomRequestHeaders, getFixedEndpointAddr, getGeneralProgressListener, getReadLimit, getRequestClientOptions, putCustomQueryParameter, putCustomRequestHeader, setCosCredentials, setFixedEndpointAddr, setGeneralProgressListener, withGeneralProgressListener

Methods inherited from class java.lang.Object

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

Field Detail

objectMetadata

public ObjectMetadata objectMetadata

Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Constructor Detail

InitiateMultipartUploadRequest

public InitiateMultipartUploadRequest(String bucketName,
                                      String key)

Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key.

Parameters:

bucketName - The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

InitiateMultipartUploadRequest

public InitiateMultipartUploadRequest(String bucketName,
                                      String key,
                                      long dataSize,
                                      long partSize)

Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified data size and part size.

Parameters:

bucketName - The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

dataSize - Size of the data upload to cos. When use encryption client, it is necessary.

partSize - Size of a part in the multipart uplaod. When use encryption client, it is necessary.

InitiateMultipartUploadRequest

public InitiateMultipartUploadRequest(String bucketName,
                                      String key,
                                      ObjectMetadata objectMetadata)

Constructs a request to initiate a new multipart upload in the specified bucket, stored by the specified key, and with the additional specified object metadata.

Parameters:

bucketName - The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Method Detail

getBucketName

public String getBucketName()

Returns the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

Parameters:

bucketName - The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

withBucketName

public InitiateMultipartUploadRequest withBucketName(String bucketName)

Sets the name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

bucketName - The name of the bucket in which to create the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

This updated InitiateMultipartUploadRequest object.

getKey

public String getKey()

Returns the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

setKey

public void setKey(String key)

Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Parameters:

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

withKey

public InitiateMultipartUploadRequest withKey(String key)

Sets the key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

key - The key by which to store the new multipart upload, and hence, the eventual object created from the multipart upload.

Returns:

This updated InitiateMultipartUploadRequest object.

getCannedACL

public CannedAccessControlList getCannedACL()

Returns the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns:

The optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

See Also:

CannedAccessControlList

setCannedACL

public void setCannedACL(CannedAccessControlList cannedACL)

Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Parameters:

cannedACL - The canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

See Also:

CannedAccessControlList

withCannedACL

public InitiateMultipartUploadRequest withCannedACL(CannedAccessControlList acl)

Sets the optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

acl - The optional canned Access Control List (ACL) to set permissions for the new object created when the multipart upload is completed.

Returns:

This updated InitiateMultipartUploadRequest object.

getAccessControlList

public AccessControlList getAccessControlList()

Returns the optional access control list for the new upload. If specified, cannedAcl will be ignored.

setAccessControlList

public void setAccessControlList(AccessControlList accessControlList)

Sets the optional access control list for the new upload. If specified, cannedAcl will be ignored.

Parameters:

accessControlList - The access control list for the new upload.

withAccessControlList

public InitiateMultipartUploadRequest withAccessControlList(AccessControlList accessControlList)

Sets the optional access control list for the new upload. If specified, cannedAcl will be ignored. Returns this InitiateMultipartUploadRequest, enabling additional method calls to be chained together.

Parameters:

accessControlList - The access control list for the new upload.

getStorageClass

public StorageClass getStorageClass()

Returns the optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

If not specified, the default is StorageClass.Standard.

Returns:

The optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

See Also:

StorageClass

setStorageClass

public void setStorageClass(StorageClass storageClass)

Sets the optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

If not specified, the default is StorageClass.Standard.

Parameters:

storageClass - The optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

See Also:

StorageClass

withStorageClass

public InitiateMultipartUploadRequest withStorageClass(StorageClass storageClass)

Sets the optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

storageClass - The optional storage class to use when storing this upload's data in COS. If not specified, the default storage class is used.

Returns:

This updated InitiateMultipartUploadRequest object.

withStorageClass

public InitiateMultipartUploadRequest withStorageClass(String storageClass)

getObjectMetadata

public ObjectMetadata getObjectMetadata()

Returns the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns:

The additional information about the new object being created, such as content type, content encoding, user metadata, etc.

setObjectMetadata

public void setObjectMetadata(ObjectMetadata objectMetadata)

Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Parameters:

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

withObjectMetadata

public InitiateMultipartUploadRequest withObjectMetadata(ObjectMetadata objectMetadata)

Sets the additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns this updated InitiateMultipartUploadRequest object so that additional method calls can be chained together.

Parameters:

objectMetadata - Additional information about the new object being created, such as content type, content encoding, user metadata, etc.

Returns:

This updated InitiateMultipartUploadRequest object.

setRedirectLocation

public void setRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object.

Parameters:

redirectLocation - The redirect location for the new object.

getRedirectLocation

public String getRedirectLocation()

Gets the optional redirect location for the new object.

withRedirectLocation

public InitiateMultipartUploadRequest withRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object. Returns this InitiateMultipartUploadRequest, enabling additional method calls to be chained together.

Parameters:

redirectLocation - The redirect location for the new object.

getSSECustomerKey

public SSECustomerKey getSSECustomerKey()

Description copied from interface: SSECustomerKeyProvider

Returns the optional customer-provided server-side encryption key to use to encrypt the uploaded object.

Specified by:

getSSECustomerKey in interface SSECustomerKeyProvider

Returns:

The optional customer-provided server-side encryption key to use to encrypt the uploaded object.

setSSECustomerKey

public void setSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the upload being started.

withSSECustomerKey

public InitiateMultipartUploadRequest withSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the upload being started, and returns the updated InitiateMultipartUploadRequest so that additional method calls may be chained together.

Parameters:

sseKey - The optional customer-provided server-side encryption key to use to encrypt the upload being started.

Returns:

The updated request object, so that additional method calls can be chained together.

getSSECOSKeyManagementParams

public SSECOSKeyManagementParams getSSECOSKeyManagementParams()

Returns the COS Key Management System parameters used to encrypt the object on server side.

Specified by:

getSSECOSKeyManagementParams in interface SSECOSKeyManagementParamsProvider

Returns:

The optional SSECOSKeyManagementParams to use to encrypt the uploaded object.

setSSECOSKeyManagementParams

public void setSSECOSKeyManagementParams(SSECOSKeyManagementParams params)

Sets the COS Key Management System parameters used to encrypt the object on server side.

withSSECOSKeyManagementParams

public InitiateMultipartUploadRequest withSSECOSKeyManagementParams(SSECOSKeyManagementParams sseCOSKeyManagementParams)

Sets the COS Key Management System parameters used to encrypt the object on server side.

Returns:

returns the update InitiateMultipartUploadRequest

setDataSizePartSize

public void setDataSizePartSize(long dataSize,
                                long partSize)

Sets the data size and part size of this multipart upload request;

Parameters:

dataSize -

partSize -

withDataSizePartSize

public InitiateMultipartUploadRequest withDataSizePartSize(long dataSize,
                                                           long partSize)

Sets the data size and part size of this multipart upload request;

Parameters:

dataSize -

partSize -

Returns:

returns the update InitiateMultipartUploadRequest

getDataSize

public long getDataSize()

getPartSize

public long getPartSize()