com.amazonaws.services.s3.model

Class PutObjectResult

java.lang.Object

com.amazonaws.services.s3.internal.SSEResultBase

com.amazonaws.services.s3.model.PutObjectResult

All Implemented Interfaces:

com.amazonaws.services.s3.internal.ObjectExpirationResult, com.amazonaws.services.s3.internal.S3RequesterChargedResult, com.amazonaws.services.s3.internal.S3VersionResult, com.amazonaws.services.s3.internal.ServerSideEncryptionResult

public class PutObjectResult
extends com.amazonaws.services.s3.internal.SSEResultBase
implements com.amazonaws.services.s3.internal.ObjectExpirationResult, com.amazonaws.services.s3.internal.S3RequesterChargedResult, com.amazonaws.services.s3.internal.S3VersionResult

Contains the data returned by Amazon S3 from the putObject operation. Use this request to access information about the new object created from the putObject request, such as its ETag and optional version ID.

See Also:

AmazonS3.putObject(String, String, java.io.File), AmazonS3#putObject(String, String, java.io.InputStream, S3ObjectMetadata), AmazonS3.putObject(PutObjectRequest)

Constructor Summary

Constructors

Constructor and Description
PutObjectResult()

Method Summary

Modifier and Type	Method and Description
java.lang.String	getContentMd5() Returns the Base64-encoded MD5 hash of the object content that was calculated on the client-side.
java.lang.String	getETag() Gets the ETag value for the newly created object.
java.util.Date	getExpirationTime() Returns the expiration time for this object, or null if it doesn't expire.
java.lang.String	getExpirationTimeRuleId() Returns the BucketLifecycleConfiguration rule ID for this object's expiration, or null if it doesn't expire.
ObjectMetadata	getMetadata() Returns the metadata retrieved as a response to AmazonS3Client#putObject(PutObjectRequest) operation.
java.lang.String	getVersionId() Gets the optional version ID of the newly uploaded object.
boolean	isRequesterCharged() Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.
void	setContentMd5(java.lang.String contentMd5) Sets the Base64-encoded MD5 hash of the object content that was calculated on the client-side.
void	setETag(java.lang.String eTag) Sets the ETag value for the new object that was created from the associated putObject request.
void	setExpirationTime(java.util.Date expirationTime) Sets the expiration time for the object.
void	setExpirationTimeRuleId(java.lang.String expirationTimeRuleId) Sets the BucketLifecycleConfiguration rule ID for this object's expiration
void	setMetadata(ObjectMetadata metadata) Sets the metadata retrieved as a response to AmazonS3Client#putObject(PutObjectRequest) operation.
void	setRequesterCharged(boolean isRequesterCharged) Used for conducting this operation from a Requester Pays Bucket.
void	setVersionId(java.lang.String versionId) Sets the optional version ID of the newly uploaded object.

Methods inherited from class com.amazonaws.services.s3.internal.SSEResultBase

getServerSideEncryption, getSSEAlgorithm, getSSECustomerAlgorithm, getSSECustomerKeyMd5, setSSEAlgorithm, setSSECustomerAlgorithm, setSSECustomerKeyMd5

Methods inherited from class java.lang.Object

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

Constructor Detail

PutObjectResult

public PutObjectResult()

Method Detail

getVersionId

public java.lang.String getVersionId()

Gets the optional version ID of the newly uploaded object. This field will be set only if object versioning is enabled for the bucket the object was uploaded to.

Specified by:

getVersionId in interface com.amazonaws.services.s3.internal.S3VersionResult

Returns:

The optional version ID of the newly uploaded object.

See Also:

setVersionId(String)

setVersionId

public void setVersionId(java.lang.String versionId)

Sets the optional version ID of the newly uploaded object.

Specified by:

setVersionId in interface com.amazonaws.services.s3.internal.S3VersionResult

Parameters:

versionId - The optional version ID of the newly uploaded object.

See Also:

getVersionId()

getETag

public java.lang.String getETag()

Gets the ETag value for the newly created object.

Returns:

The ETag value for the new object.

See Also:

setETag(String)

setETag

public void setETag(java.lang.String eTag)

Sets the ETag value for the new object that was created from the associated putObject request.

Parameters:

eTag - The ETag value for the new object.

See Also:

getETag()

getExpirationTime

public java.util.Date getExpirationTime()

Returns the expiration time for this object, or null if it doesn't expire.

Specified by:

getExpirationTime in interface com.amazonaws.services.s3.internal.ObjectExpirationResult

Returns:

Date the expiration time.

setExpirationTime

public void setExpirationTime(java.util.Date expirationTime)

Sets the expiration time for the object.

Specified by:

setExpirationTime in interface com.amazonaws.services.s3.internal.ObjectExpirationResult

Parameters:

expirationTime - The expiration time for the object.

getExpirationTimeRuleId

public java.lang.String getExpirationTimeRuleId()

Returns the BucketLifecycleConfiguration rule ID for this object's expiration, or null if it doesn't expire.

Specified by:

getExpirationTimeRuleId in interface com.amazonaws.services.s3.internal.ObjectExpirationResult

Returns:

String the expiration time rule ID.

See Also:

BucketLifecycleConfiguration.Rule.getId()

setExpirationTimeRuleId

public void setExpirationTimeRuleId(java.lang.String expirationTimeRuleId)

Sets the BucketLifecycleConfiguration rule ID for this object's expiration

Specified by:

setExpirationTimeRuleId in interface com.amazonaws.services.s3.internal.ObjectExpirationResult

Parameters:

expirationTimeRuleId - The rule ID for this object's expiration

setContentMd5

public void setContentMd5(java.lang.String contentMd5)

Sets the Base64-encoded MD5 hash of the object content that was calculated on the client-side.

Parameters:

contentMd5 - The content MD5

getContentMd5

public java.lang.String getContentMd5()

Returns the Base64-encoded MD5 hash of the object content that was calculated on the client-side. This method returns null if the MD5 validation is disabled and the caller didn't provide the MD5 hash in the ObjectMetadata when sending the PutObjectRequest.

getMetadata

public ObjectMetadata getMetadata()

Returns the metadata retrieved as a response to AmazonS3Client#putObject(PutObjectRequest) operation.

setMetadata

public void setMetadata(ObjectMetadata metadata)

Sets the metadata retrieved as a response to AmazonS3Client#putObject(PutObjectRequest) operation.

isRequesterCharged

public boolean isRequesterCharged()

Description copied from interface: com.amazonaws.services.s3.internal.S3RequesterChargedResult

Returns true if the user has enabled Requester Pays option when conducting this operation from Requester Pays Bucket; else false.

If a bucket is enabled for Requester Pays, then any attempt of operation from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Enabling Requester Pays disables the ability to have anonymous access to this bucket

Specified by:

isRequesterCharged in interface com.amazonaws.services.s3.internal.S3RequesterChargedResult

Returns:

true if the user has enabled Requester Pays option for conducting this operation from Requester Pays Bucket.

setRequesterCharged

public void setRequesterCharged(boolean isRequesterCharged)

Description copied from interface: com.amazonaws.services.s3.internal.S3RequesterChargedResult

Used for conducting this operation from a Requester Pays Bucket. If set the requester is charged for conducting the operation from the bucket.

If a bucket is enabled for Requester Pays, then any attempt of operation from it without Requester Pays enabled will result in a 403 error and the bucket owner will be charged for the request.

Specified by:

setRequesterCharged in interface com.amazonaws.services.s3.internal.S3RequesterChargedResult

Parameters:

isRequesterCharged - Indicates requester is charged for this operation.