com.sinacloud.scs.services.scs.model

类 PutObjectRelaxRequest

java.lang.Object

com.sinacloud.scs.SCSWebServiceRequest

com.sinacloud.scs.services.scs.model.PutObjectRelaxRequest

public class PutObjectRelaxRequest
extends SCSWebServiceRequest

秒传请求对象

构造器概要

构造器

构造器和说明
PutObjectRelaxRequest(String bucketName, String key, String fileSha1, long fileLength) 创建秒传请求对象
PutObjectRelaxRequest(String bucketName, String key, String fileSha1, long fileLength, CannedAccessControlList cannedAcl)

方法概要

方法

限定符和类型	方法和说明
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.
long	getFileLength()
String	getFileSha1()
ProgressListener	getGeneralProgressListener() Returns the optional progress listener for receiving updates about object download status.
String	getKey() Gets the key under which to store the new object.
ObjectMetadata	getMetadata() Gets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
ProgressListener	getProgressListener() 已过时。 use getGeneralProgressListener() instead.
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	setFileLength(long fileLength)
void	setFileSha1(String fileSha1)
void	setGeneralProgressListener(ProgressListener generalProgressListener) Sets the optional progress listener for receiving updates about object download status.
void	setKey(String key) Sets the key under which to store the new object.
void	setMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
void	setProgressListener(ProgressListener progressListener) 已过时。 use setGeneralProgressListener(ProgressListener) instead.
PutObjectRelaxRequest	withBucketName(String bucketName) Sets the name of the bucket where this request will upload a new object to.
PutObjectRelaxRequest	withCannedAcl(CannedAccessControlList cannedAcl) Sets the optional pre-configured access control policy to use for the new object.
PutObjectRelaxRequest	withGeneralProgressListener(ProgressListener generalProgressListener) Sets the optional progress listener for receiving updates about object upload status, and returns this updated object so that additional method calls can be chained together.
PutObjectRelaxRequest	withKey(String key) Sets the key under which to store the new object.
PutObjectRelaxRequest	withMetadata(ObjectMetadata metadata) Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.).
PutObjectRelaxRequest	withProgressListener(ProgressListener progressListener) 已过时。 use withGeneralProgressListener(ProgressListener) instead.

从类继承的方法 com.sinacloud.scs.SCSWebServiceRequest

copyPrivateRequestParameters, getDelegationToken, getRequestClientOptions, getRequestCredentials, setDelegationToken, setRequestCredentials

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

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

构造器详细资料

PutObjectRelaxRequest

public PutObjectRelaxRequest(String bucketName,
                     String key,
                     String fileSha1,
                     long fileLength)

创建秒传请求对象

参数:

bucketName -

key -

fileSha1 - 文件sha1值

fileLength - 文件大小

PutObjectRelaxRequest

public PutObjectRelaxRequest(String bucketName,
                     String key,
                     String fileSha1,
                     long fileLength,
                     CannedAccessControlList cannedAcl)

方法详细资料

getFileSha1

public String getFileSha1()

setFileSha1

public void setFileSha1(String fileSha1)

getFileLength

public long getFileLength()

setFileLength

public void setFileLength(long fileLength)

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 PutObjectRelaxRequest 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 PutObjectRelaxRequest, 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 PutObjectRelaxRequest 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 PutObjectRelaxRequest, enabling additional method calls to be chained together.

另请参阅:

getKey(), setKey(String)

getMetadata

public ObjectMetadata getMetadata()

Gets the optional metadata instructing Amazon S3 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 Amazon S3. This can cause very negative performance impacts.

返回:

The optional metadata instructing Amazon S3 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 Amazon S3 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 Amazon S3. This can cause very negative performance impacts.

参数:

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

另请参阅:

getMetadata(), withMetadata(ObjectMetadata)

withMetadata

public PutObjectRelaxRequest withMetadata(ObjectMetadata metadata)

Sets the optional metadata instructing Amazon S3 how to handle the uploaded data (e.g. custom user metadata, hooks for specifying content type, etc.). Returns this PutObjectRelaxRequest, 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 Amazon S3. This can cause very negative performance impacts.

参数:

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

返回:

This PutObjectRelaxRequest, 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 PutObjectRelaxRequest withCannedAcl(CannedAccessControlList cannedAcl)

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

参数:

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

返回:

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

另请参阅:

getCannedAcl(), setCannedAcl(CannedAccessControlList)

setProgressListener

@Deprecated
public void setProgressListener(ProgressListener progressListener)

已过时。 use setGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates for object upload status.

参数:

progressListener - The legacy progress listener that is used exclusively for Amazon S3 client.

getProgressListener

@Deprecated
public ProgressListener getProgressListener()

已过时。 use getGeneralProgressListener() instead.

Returns the optional progress listener for receiving updates about object upload status.

返回:

the optional progress listener for receiving updates about object upload status.

withProgressListener

@Deprecated
public PutObjectRelaxRequest withProgressListener(ProgressListener progressListener)

已过时。 use withGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates about object upload status, and returns this updated object so that additional method calls can be chained together.

参数:

progressListener - The legacy progress listener that is used exclusively for Amazon S3 client.

返回:

This updated PutObjectRequest object.

setGeneralProgressListener

public void setGeneralProgressListener(ProgressListener generalProgressListener)

Sets the optional progress listener for receiving updates about object download status.

参数:

generalProgressListener - The new progress listener.

getGeneralProgressListener

public ProgressListener getGeneralProgressListener()

Returns the optional progress listener for receiving updates about object download status.

返回:

the optional progress listener for receiving updates about object download status.

withGeneralProgressListener

public PutObjectRelaxRequest withGeneralProgressListener(ProgressListener generalProgressListener)

Sets the optional progress listener for receiving updates about object upload status, and returns this updated object so that additional method calls can be chained together.

参数:

generalProgressListener - The new progress listener.

返回:

This updated PutObjectRequest object.