com.qcloud.cos.model

类 AbstractPutObjectRequest

java.lang.Object

com.qcloud.cos.internal.CosServiceRequest

com.qcloud.cos.model.AbstractPutObjectRequest

所有已实现的接口:

ReadLimitInfo, CosDataSource, SSECOSKeyManagementParamsProvider, SSECustomerKeyProvider, Serializable, Cloneable

直接已知子类:

PutObjectRequest

public abstract class AbstractPutObjectRequest
extends CosServiceRequest
implements Cloneable, SSECustomerKeyProvider, SSECOSKeyManagementParamsProvider, CosDataSource, Serializable

另请参阅:

序列化表格

嵌套类概要

从接口继承的嵌套类/接口 com.qcloud.cos.model.CosDataSource

CosDataSource.Utils

构造器概要

构造器

限定符	构造器和说明
	AbstractPutObjectRequest(String bucketName, String key, File file) Constructs a new AbstractPutObjectRequest object to upload a file to the specified bucket and key.
protected	AbstractPutObjectRequest(String bucketName, String key, InputStream input, ObjectMetadata metadata) Constructs a new AbstractPutObjectRequest object to upload a stream of data to the specified bucket and key.
	AbstractPutObjectRequest(String bucketName, String key, String redirectLocation) Constructs a new AbstractPutObjectRequest object with redirect location.

方法概要

方法

限定符和类型	方法和说明
abstract AbstractPutObjectRequest	clone()
protected <T extends AbstractPutObjectRequest> T	copyPutObjectBaseTo(T target)
AccessControlList	getAccessControlList() Returns the optional access control list for the new object.
String	getBucketName() Gets the name of the existing bucket where this request will upload a new object to.
CannedAccessControlList	getCannedAcl() Gets the optional pre-configured access control policy to use for the new object.
File	getFile() Gets the path and name of the file containing the data to be uploaded to Qcloud COS.
InputStream	getInputStream() Gets the input stream containing the data to be uploaded to Qcloud COS.
String	getKey() Gets the key under which to store the new object.
ObjectMetadata	getMetadata() Gets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
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.
String	getStorageClass() Gets the optional Qcloud COS storage class to use when storing the new object.
void	setAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new object.
void	setBucketName(String bucketName) Sets the name of an existing bucket where this request will upload a new object to.
void	setCannedAcl(CannedAccessControlList cannedAcl) Sets the optional pre-configured access control policy to use for the new object.
void	setFile(File file) Sets the path and name of the file containing the data to be uploaded to Qcloud COS.
void	setInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Qcloud COS.
void	setKey(String key) Sets the key under which to store the new object.
void	setMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, 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 uploaded object.
void	setStorageClass(StorageClass storageClass) Sets the optional Qcloud COS storage class to use when storing the new object.
void	setStorageClass(String storageClass) Sets the optional Qcloud COS storage class to use when storing the new object.
<T extends AbstractPutObjectRequest> T	withAccessControlList(AccessControlList accessControlList) Sets the optional access control list for the new object.
<T extends AbstractPutObjectRequest> T	withBucketName(String bucketName) Sets the name of the bucket where this request will upload a new object to.
<T extends AbstractPutObjectRequest> T	withCannedAcl(CannedAccessControlList cannedAcl) Sets the optional pre-configured access control policy to use for the new object.
<T extends AbstractPutObjectRequest> T	withFile(File file) Sets the file containing the data to be uploaded to Qcloud COS.
<T extends AbstractPutObjectRequest> T	withInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Qcloud COS.
<T extends AbstractPutObjectRequest> T	withKey(String key) Sets the key under which to store the new object.
<T extends AbstractPutObjectRequest> T	withMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
<T extends AbstractPutObjectRequest> T	withRedirectLocation(String redirectLocation) Sets the optional redirect location for the new object.Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.
<T extends AbstractPutObjectRequest> T	withSSECOSKeyManagementParams(SSECOSKeyManagementParams sseCOSKeyManagementParams) Sets the COS Key Management System parameters used to encrypt the object on server side.
<T extends AbstractPutObjectRequest> T	withSSECustomerKey(SSECustomerKey sseKey) Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object, and returns the updated request object so that additional method calls can be chained together.
<T extends AbstractPutObjectRequest> T	withStorageClass(StorageClass storageClass) Sets the optional Qcloud COS storage class to use when storing the new object.
<T extends AbstractPutObjectRequest> T	withStorageClass(String storageClass) Sets the optional Qcloud COS storage class to use when storing the new object.

从类继承的方法 com.qcloud.cos.internal.CosServiceRequest

copyBaseTo, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, withGeneralProgressListener

从类继承的方法 java.lang.Object

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

构造器详细资料

AbstractPutObjectRequest

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

Constructs a new AbstractPutObjectRequest object to upload a file to the specified bucket and key. After constructing the request, users may optionally specify object metadata or a canned ACL as well.

参数:

bucketName - The name of an existing bucket to which the new object will be uploaded.

key - The key under which to store the new object.

file - The path of the file to upload to Qcloud COS.

AbstractPutObjectRequest

public AbstractPutObjectRequest(String bucketName,
                        String key,
                        String redirectLocation)

Constructs a new AbstractPutObjectRequest object with redirect location. After constructing the request, users may optionally specify object metadata or a canned ACL as well.

参数:

bucketName - The name of an existing bucket to which the new object will be uploaded.

key - The key under which to store the new object.

redirectLocation - The redirect location of this new object.

AbstractPutObjectRequest

protected AbstractPutObjectRequest(String bucketName,
                        String key,
                        InputStream input,
                        ObjectMetadata metadata)

Constructs a new AbstractPutObjectRequest object to upload a stream of data to the specified bucket and key. After constructing the request, users may optionally specify object metadata or a canned ACL as well.

Content length for the data stream must be specified in the object metadata parameter; Qcloud COS requires it be passed in before the data is uploaded. Failure to specify a content length will cause the entire contents of the input stream to be buffered locally in memory so that the content length can be calculated, which can result in negative performance problems.

参数:

bucketName - The name of an existing bucket to which the new object will be uploaded.

key - The key under which to store the new object.

input - The stream of data to upload to Qcloud COS.

metadata - The object metadata. At minimum this specifies the content length for the stream of data being uploaded.

方法详细资料

getBucketName

public String getBucketName()

Gets the name of the existing bucket where this request will upload a new object to. In order to upload the object, users must have Permission.Write permission granted.

返回:

The name of an existing bucket where this request will upload a new object to.

另请参阅:

setBucketName(String), withBucketName(String)

setBucketName

public void setBucketName(String bucketName)

Sets the name of an existing bucket where this request will upload a new object to. In order to upload the object, users must have Permission.Write permission granted.

参数:

bucketName - The name of an existing bucket where this request will upload a new object to. In order to upload the object, users must have Permission.Write permission granted.

另请参阅:

getBucketName(), withBucketName(String)

withBucketName

public <T extends AbstractPutObjectRequest> T withBucketName(String bucketName)

Sets the name of the bucket where this request will upload a new object to. Returns this object, enabling additional method calls to be chained together.

In order to upload the object, users must have Permission.Write permission granted.

参数:

bucketName - The name of an existing bucket where this request will upload a new object to. In order to upload the object, users must have Permission.Write permission granted.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getBucketName(), setBucketName(String)

getKey

public String getKey()

Gets the key under which to store the new object.

返回:

The key under which to store the new object.

另请参阅:

setKey(String), withKey(String)

setKey

public void setKey(String key)

Sets the key under which to store the new object.

参数:

key - The key under which to store the new object.

另请参阅:

getKey(), withKey(String)

withKey

public <T extends AbstractPutObjectRequest> T withKey(String key)

Sets the key under which to store the new object. Returns this object, enabling additional method calls to be chained together.

参数:

key - The key under which to store the new object.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getKey(), setKey(String)

getStorageClass

public String getStorageClass()

Gets the optional Qcloud COS storage class to use when storing the new object. If not specified, the default standard storage class is used when storing the object.

For more information on available Qcloud COS storage classes, see the StorageClass enumeration.

返回:

The Qcloud COS storage class to use when storing the newly copied object.

另请参阅:

setStorageClass(String), setStorageClass(StorageClass), withStorageClass(StorageClass), withStorageClass(String)

setStorageClass

public void setStorageClass(String storageClass)

Sets the optional Qcloud COS storage class to use when storing the new object. If not specified, the default standard storage class will be used when storing the new object.

For more information on Qcloud COS storage classes and available values, see the StorageClass enumeration.

参数:

storageClass - The storage class to use when storing the new object.

另请参阅:

getStorageClass(), setStorageClass(String), withStorageClass(StorageClass), withStorageClass(String)

withStorageClass

public <T extends AbstractPutObjectRequest> T withStorageClass(String storageClass)

Sets the optional Qcloud COS storage class to use when storing the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together. If not specified, the default standard storage class will be used when storing the object.

For more information on Qcloud COS storage classes and available values, see the StorageClass enumeration.

参数:

storageClass - The storage class to use when storing the new object.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getStorageClass(), setStorageClass(StorageClass), setStorageClass(String), withStorageClass(StorageClass)

setStorageClass

public void setStorageClass(StorageClass storageClass)

Sets the optional Qcloud COS storage class to use when storing the new object. If not specified, the default standard storage class will be used when storing the object.

For more information on Qcloud COS storage classes and available values, see the StorageClass enumeration.

参数:

storageClass - The storage class to use when storing the new object.

另请参阅:

getStorageClass(), setStorageClass(String)

withStorageClass

public <T extends AbstractPutObjectRequest> T withStorageClass(StorageClass storageClass)

Sets the optional Qcloud COS storage class to use when storing the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together. If not specified, the default standard storage class will be used when storing the object.

For more information on Qcloud COS storage classes and available values, see the StorageClass enumeration.

参数:

storageClass - The storage class to use when storing the new object.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getStorageClass(), setStorageClass(StorageClass), setStorageClass(String), withStorageClass(String)

getFile

public File getFile()

Gets the path and name of the file containing the data to be uploaded to Qcloud COS. Either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

指定者:

getFile 在接口中 CosDataSource

返回:

The path and name of the file containing the data to be uploaded to Qcloud COS.

另请参阅:

setFile(File), withFile(File), setInputStream(InputStream), withInputStream(InputStream)

setFile

public void setFile(File file)

Sets the path and name of the file containing the data to be uploaded to Qcloud COS. Either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

指定者:

setFile 在接口中 CosDataSource

参数:

file - The path and name of the file containing the data to be uploaded to Qcloud COS.

另请参阅:

getFile(), withFile(File), getInputStream(), withInputStream(InputStream)

withFile

public <T extends AbstractPutObjectRequest> T withFile(File file)

Sets the file containing the data to be uploaded to Qcloud COS. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

Either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

参数:

file - The file containing the data to be uploaded to Qcloud COS.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getFile(), setFile(File), getInputStream(), setInputStream(InputStream)

getMetadata

public ObjectMetadata getMetadata()

Gets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Qcloud COS. This can cause very negative performance impacts.

返回:

The optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

另请参阅:

setMetadata(ObjectMetadata), withMetadata(ObjectMetadata)

setMetadata

public void setMetadata(ObjectMetadata metadata)

Sets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Qcloud COS. This can cause very negative performance impacts.

参数:

metadata - The optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

另请参阅:

getMetadata(), withMetadata(ObjectMetadata)

withMetadata

public <T extends AbstractPutObjectRequest> T withMetadata(ObjectMetadata metadata)

Sets the optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.). Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

If uploading from an input stream, always specify metadata with the content size set. Otherwise the contents of the input stream have to be buffered in memory before being sent to Qcloud COS. This can cause very negative performance impacts.

参数:

metadata - The optional metadata instructing Qcloud COS how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getMetadata(), setMetadata(ObjectMetadata)

getCannedAcl

public CannedAccessControlList getCannedAcl()

Gets the optional pre-configured access control policy to use for the new object.

返回:

The optional pre-configured access control policy to use for the new object.

另请参阅:

setCannedAcl(CannedAccessControlList), withCannedAcl(CannedAccessControlList)

setCannedAcl

public void setCannedAcl(CannedAccessControlList cannedAcl)

Sets the optional pre-configured access control policy to use for the new object.

参数:

cannedAcl - The optional pre-configured access control policy to use for the new object.

另请参阅:

getCannedAcl(), withCannedAcl(CannedAccessControlList)

withCannedAcl

public <T extends AbstractPutObjectRequest> T withCannedAcl(CannedAccessControlList cannedAcl)

Sets the optional pre-configured access control policy to use for the new object. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

参数:

cannedAcl - The optional pre-configured access control policy to use for the new object.

返回:

This AbstractPutObjectRequest, enabling additional method calls to be chained together.

另请参阅:

getCannedAcl(), setCannedAcl(CannedAccessControlList)

getAccessControlList

public AccessControlList getAccessControlList()

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

setAccessControlList

public void setAccessControlList(AccessControlList accessControlList)

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

参数:

accessControlList - The access control list for the new object.

withAccessControlList

public <T extends AbstractPutObjectRequest> T withAccessControlList(AccessControlList accessControlList)

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

参数:

accessControlList - The access control list for the new object.

getInputStream

public InputStream getInputStream()

Gets the input stream containing the data to be uploaded to Qcloud COS. The user of this request must either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

指定者:

getInputStream 在接口中 CosDataSource

返回:

The input stream containing the data to be uploaded to Qcloud COS. Either specify a file or an input stream containing the data to be uploaded to Qcloud COS, not both.

另请参阅:

setInputStream(InputStream), withInputStream(InputStream), setFile(File), withFile(File)

setInputStream

public void setInputStream(InputStream inputStream)

Sets the input stream containing the data to be uploaded to Qcloud COS. Either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

指定者:

setInputStream 在接口中 CosDataSource

参数:

inputStream - The input stream containing the data to be uploaded to Qcloud COS. Either specify a file or an input stream containing the data to be uploaded to Qcloud COS, not both.

另请参阅:

getInputStream(), withInputStream(InputStream), getFile(), withFile(File)

withInputStream

public <T extends AbstractPutObjectRequest> T withInputStream(InputStream inputStream)

Sets the input stream containing the data to be uploaded to Qcloud COS. Returns this AbstractPutObjectRequest, enabling additional method calls to be chained together.

Either specify a file or an input stream containing the data to be uploaded to Qcloud COS; both cannot be specified.

参数:

inputStream - The InputStream containing the data to be uploaded to Qcloud COS.

返回:

This PutObjectRequest, so that additional method calls can be chained together.

另请参阅:

getInputStream(), setInputStream(InputStream), getFile(), setFile(File)

setRedirectLocation

public void setRedirectLocation(String redirectLocation)

Sets the optional redirect location for the new object.

参数:

redirectLocation - The redirect location for the new object.

getRedirectLocation

public String getRedirectLocation()

Gets the optional redirect location for the new object.

withRedirectLocation

public <T extends AbstractPutObjectRequest> T withRedirectLocation(String redirectLocation)

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

参数:

redirectLocation - The redirect location for the new object.

getSSECustomerKey

public SSECustomerKey getSSECustomerKey()

从接口复制的说明: SSECustomerKeyProvider

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

指定者:

getSSECustomerKey 在接口中 SSECustomerKeyProvider

返回:

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 uploaded object.

参数:

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

withSSECustomerKey

public <T extends AbstractPutObjectRequest> T withSSECustomerKey(SSECustomerKey sseKey)

Sets the optional customer-provided server-side encryption key to use to encrypt the uploaded object, and returns the updated request object so that additional method calls can be chained together.

参数:

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

返回:

This 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.

指定者:

getSSECOSKeyManagementParams 在接口中 SSECOSKeyManagementParamsProvider

返回:

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 <T extends AbstractPutObjectRequest> T withSSECOSKeyManagementParams(SSECOSKeyManagementParams sseCOSKeyManagementParams)

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

返回:

returns the update PutObjectRequest

clone

public abstract AbstractPutObjectRequest clone()

覆盖:

clone 在类中 Object

copyPutObjectBaseTo

protected final <T extends AbstractPutObjectRequest> T copyPutObjectBaseTo(T target)