com.baidubce.services.bos.model

Class PutObjectRequest

java.lang.Object

com.baidubce.model.AbstractBceRequest

com.baidubce.services.bos.model.GenericBucketRequest

com.baidubce.services.bos.model.GenericObjectRequest

com.baidubce.services.bos.model.PutObjectRequest

Direct Known Subclasses:

AppendObjectRequest

public class PutObjectRequest
extends GenericObjectRequest

Uploads a new object to the specified Baidu Bos bucket. The PutObjectRequest optionally uploads object metadata and applies a canned access control policy to the new object.

Baidu Bos never stores partial objects; if during this call an exception wasn't thrown, the entire object was stored.

Field Summary

Fields inherited from class com.baidubce.services.bos.model.GenericObjectRequest

trafficLimitBitPS

Constructor Summary

Constructors

Modifier	Constructor and Description
	PutObjectRequest(String bucketName, String key, File file) Constructs a new PutObjectRequest object to upload a file to the specified bucket and key.
protected	PutObjectRequest(String bucketName, String key, File file, InputStream inputStream, ObjectMetadata objectMetadata) Constructs a new PutObjectRequest object to upload a file and a stream of data to the specified bucket and key.
	PutObjectRequest(String bucketName, String key, File file, ObjectMetadata metadata) Constructs a new PutObjectRequest object to upload a file to the specified bucket and key.
	PutObjectRequest(String bucketName, String key, InputStream inputStream) Constructs a new PutObjectRequest object to upload a stream of data to the specified bucket and key.
	PutObjectRequest(String bucketName, String key, InputStream inputStream, BosProgressCallback progressCallback) Constructs a new PutObjectRequest object to upload a stream of data to the specified bucket and key.
	PutObjectRequest(String bucketName, String key, InputStream inputStream, ObjectMetadata metadata) Constructs a new PutObjectRequest object to upload a stream of data to the specified bucket and key.

Method Summary

Modifier and Type	Method and Description
File	getFile() Gets the path and name of the file containing the data to be uploaded to Baidu Bos.
InputStream	getInputStream() Gets the input stream containing the data to be uploaded to Baidu Bos.
ObjectMetadata	getObjectMetadata() Gets the optional metadata instructing Baidu Bos how to handle the uploaded data (e.g.
BosProgressCallback	getProgressCallback() Gets the BosProgressCallback which used for Get upload progress.
String	getStorageClass() Gets the storageClass of the input file which is be uploaded to Baidu Bos.
long	getTrafficLimitBitPS() Gets the limit of put object speed.
String	getVideoProcess() Gets the parameter of Audio and video processing
void	setFile(File file) Sets the path and name of the file containing the data to be uploaded to Baidu Bos.
void	setInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Baidu Bos.
void	setObjectMetadata(ObjectMetadata objectMetadata) Sets the optional metadata instructing Baidu Bos how to handle the uploaded data (e.g.
void	setProgressCallback(BosProgressCallback progressCallback) Sets the BosProgressCallback which used for Get upload progress.
void	setStorageClass(String storageClass) Sets the storageClass of the input file which is be uploaded to Baidu Bos.
void	setTrafficLimitBitPS(long trafficLimitBitPS) Sets Gets the limit of put object speed.
void	setVideoProcess(String videoProcess)
PutObjectRequest	withBucketName(String bucketName) Sets the name of the bucket where this request will upload a new object to.
PutObjectRequest	withFile(File file) Sets the file containing the data to be uploaded to Baidu Bos.
PutObjectRequest	withInputStream(InputStream inputStream) Sets the input stream containing the data to be uploaded to Baidu Bos.
PutObjectRequest	withKey(String key) Sets the key under which to store the new object.
PutObjectRequest	withObjectMetadata(ObjectMetadata objectMetadata) Sets the optional metadata instructing Baidu Bos how to handle the uploaded data (e.g.
PutObjectRequest	withProgressCallback(BosProgressCallback progressCallback)
PutObjectRequest	withRequestCredentials(BceCredentials credentials)
PutObjectRequest	withStorageClass(String storageClass) Sets the storageClass of the input file which is be uploaded to Baidu Bos.
PutObjectRequest	withTrafficLimitBitPS(long trafficLimitBitPS)
PutObjectRequest	withVideoProcess(String videoProcess)

Methods inherited from class com.baidubce.services.bos.model.GenericObjectRequest

getKey, setKey

Methods inherited from class com.baidubce.services.bos.model.GenericBucketRequest

getBucketName, setBucketName

Methods inherited from class com.baidubce.model.AbstractBceRequest

getRequestCredentials, setRequestCredentials

Methods inherited from class java.lang.Object

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

Constructor Detail

PutObjectRequest

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

Constructs a new PutObjectRequest 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.

Parameters:

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 Baidu Bos.

PutObjectRequest

public PutObjectRequest(String bucketName,
                        String key,
                        File file,
                        ObjectMetadata metadata)

Constructs a new PutObjectRequest 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.

Parameters:

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 Baidu Bos.

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

PutObjectRequest

public PutObjectRequest(String bucketName,
                        String key,
                        InputStream inputStream)

Constructs a new PutObjectRequest 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.

Parameters:

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.

inputStream - The stream of data to upload to Baidu Bos.

PutObjectRequest

public PutObjectRequest(String bucketName,
                        String key,
                        InputStream inputStream,
                        BosProgressCallback progressCallback)

Constructs a new PutObjectRequest 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.

Parameters:

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.

inputStream - The stream of data to upload to Baidu Bos.

progressCallback - The BosProgressCallback, which used for get progress information.

PutObjectRequest

public PutObjectRequest(String bucketName,
                        String key,
                        InputStream inputStream,
                        ObjectMetadata metadata)

Constructs a new PutObjectRequest 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.

Parameters:

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.

inputStream - The stream of data to upload to Baidu Bos.

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

PutObjectRequest

protected PutObjectRequest(String bucketName,
                           String key,
                           File file,
                           InputStream inputStream,
                           ObjectMetadata objectMetadata)

Constructs a new PutObjectRequest object to upload a file and 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.

Parameters:

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 Baidu Bos.

inputStream - The stream of data to upload to Baidu Bos.

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

Method Detail

withRequestCredentials

public PutObjectRequest withRequestCredentials(BceCredentials credentials)

Specified by:

withRequestCredentials in class AbstractBceRequest

withBucketName

public PutObjectRequest 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.

Specified by:

withBucketName in class GenericBucketRequest

Parameters:

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

Returns:

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

withKey

public PutObjectRequest withKey(String key)

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

Specified by:

withKey in class GenericObjectRequest

Parameters:

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

Returns:

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

getFile

public File getFile()

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

Returns:

The path and name of the file containing the data to be uploaded to Baidu Bos.

setFile

public void setFile(File file)

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

Parameters:

file - The path and name of the file containing the data to be uploaded to Baidu Bos.

withFile

public PutObjectRequest withFile(File file)

Sets the file containing the data to be uploaded to Baidu Bos. Returns this PutObjectRequest, enabling additional method calls to be chained together.

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

Parameters:

file - The file containing the data to be uploaded to Baidu Bos.

Returns:

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

getObjectMetadata

public ObjectMetadata getObjectMetadata()

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

Returns:

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

setObjectMetadata

public void setObjectMetadata(ObjectMetadata objectMetadata)

Sets the optional metadata instructing Baidu Bos 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 Baidu Bos. This can cause very negative performance impacts.

Parameters:

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

withObjectMetadata

public PutObjectRequest withObjectMetadata(ObjectMetadata objectMetadata)

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

Parameters:

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

Returns:

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

getInputStream

public InputStream getInputStream()

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

Returns:

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

setInputStream

public void setInputStream(InputStream inputStream)

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

Parameters:

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

withInputStream

public PutObjectRequest withInputStream(InputStream inputStream)

Sets the input stream containing the data to be uploaded to Baidu Bos. Returns this PutObjectRequest, enabling additional method calls to be chained together.

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

Parameters:

inputStream - The InputStream containing the data to be uploaded to Baidu Bos.

Returns:

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

getStorageClass

public String getStorageClass()

Gets the storageClass of the input file which is be uploaded to Baidu Bos.

Returns:

storageClass The StorageClass is an identification that distinguish between infrequent access bos and standard bos.

setStorageClass

public void setStorageClass(String storageClass)

Sets the storageClass of the input file which is be uploaded to Baidu Bos.

Parameters:

storageClass - The StorageClass is an identification that distinguish between infrequent access bos and standard bos.

withStorageClass

public PutObjectRequest withStorageClass(String storageClass)

Sets the storageClass of the input file which is be uploaded to Baidu Bos.

Parameters:

storageClass - The StorageClass is an identification that distinguish between infrequent access bos and standard bos.

Returns:

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

getProgressCallback

public BosProgressCallback getProgressCallback()

Gets the BosProgressCallback which used for Get upload progress.

Returns:

The BosProgressCallback which used for get progress information.

setProgressCallback

public void setProgressCallback(BosProgressCallback progressCallback)

Sets the BosProgressCallback which used for Get upload progress.

Parameters:

progressCallback - The BosProgressCallback, which used for get progress information.

withProgressCallback

public PutObjectRequest withProgressCallback(BosProgressCallback progressCallback)

Parameters:

progressCallback - The BosProgressCallback, which used for get progress information.

Returns:

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

getTrafficLimitBitPS

public long getTrafficLimitBitPS()

Gets the limit of put object speed.

Returns:

the limit of put object speed. unit: bit/s

setTrafficLimitBitPS

public void setTrafficLimitBitPS(long trafficLimitBitPS)

Sets Gets the limit of put object speed. range: 819200 bit/s ~ 838860800 bit/s

Parameters:

trafficLimitBitPS - the limit of put object speed. unit: bit/s

withTrafficLimitBitPS

public PutObjectRequest withTrafficLimitBitPS(long trafficLimitBitPS)

Parameters:

trafficLimitBitPS - the limit of put object speed. unit: bit/s, range: 819200 bit/s ~ 838860800 bit/s

Returns:

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

getVideoProcess

public String getVideoProcess()

Gets the parameter of Audio and video processing

Returns:

the parameter of Audio and video processing

setVideoProcess

public void setVideoProcess(String videoProcess)

Parameters:

videoProcess - The parameter of Audio and video processing

withVideoProcess

public PutObjectRequest withVideoProcess(String videoProcess)

Parameters:

videoProcess - The parameter of Audio and video processing

Returns:

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