com.sinacloud.scs.services.scs.model

类 GetObjectRequest

java.lang.Object

com.sinacloud.scs.SCSWebServiceRequest

com.sinacloud.scs.services.scs.model.GetObjectRequest

public class GetObjectRequest
extends SCSWebServiceRequest

Provides options for downloading an Amazon S3 object.

All GetObjectRequests must specify a bucket name and key. Beyond that, requests can also specify:

• The range of bytes within the object to download,
• Constraints controlling if the object will be downloaded or not.

另请参阅:

GetObjectRequest(String, String), GetObjectRequest(String, String, String), GetObjectMetadataRequest

构造器概要

构造器

构造器和说明
GetObjectRequest(String bucketName, String key) Constructs a new GetObjectRequest with all the required parameters.
GetObjectRequest(String bucketName, String key, String versionId) Constructs a new GetObjectRequest with all the required parameters.

方法概要

方法

限定符和类型	方法和说明
String	getBucketName() Gets the name of the bucket containing the object to be downloaded.
ProgressListener	getGeneralProgressListener() Returns the optional progress listener for receiving updates about object download status.
String	getKey() Gets the key under which the object to be downloaded is stored.
List<String>	getMatchingETagConstraints() Gets the optional list of ETag constraints that, when present, must include a match for the object's current ETag in order for this request to be executed.
Date	getModifiedSinceConstraint() Gets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.
List<String>	getNonmatchingETagConstraints() Gets the optional list of ETag constraints that when present, must not include a match for the object's current ETag in order for this request to be executed.
ProgressListener	getProgressListener() 已过时。 use getGeneralProgressListener() instead.
long[]	getRange() Gets the optional inclusive byte range within the desired object that will be downloaded by this request.
ResponseHeaderOverrides	getResponseHeaders() Returns the headers to be overridden in the service response.
Date	getUnmodifiedSinceConstraint() Gets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.
String	getVersionId() Gets the optional version ID specifying which version of the object to download.
void	setBucketName(String bucketName) Sets the name of the bucket containing the object to be downloaded.
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 the object to be downloaded is stored.
void	setMatchingETagConstraints(List<String> eTagList) Sets the optional list of ETag constraints that when present must include a match for the object's current ETag in order for this request to be executed.
void	setModifiedSinceConstraint(Date date) Sets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.
void	setNonmatchingETagConstraints(List<String> eTagList) Sets the optional list of ETag constraints that when present must not include a match for the object's current ETag in order for this request to be executed.
void	setProgressListener(ProgressListener progressListener) 已过时。 use setGeneralProgressListener(ProgressListener) instead.
void	setRange(long start, long end) Sets the optional inclusive byte range within the desired object that will be downloaded by this request.
void	setResponseHeaders(ResponseHeaderOverrides responseHeaders) Sets the headers to be overridden in the service response.
void	setUnmodifiedSinceConstraint(Date date) Sets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.
void	setVersionId(String versionId) Sets the optional version ID specifying which version of the object to download.
GetObjectRequest	withBucketName(String bucketName) Sets the name of the bucket containing the object to be downloaded.
GetObjectRequest	withGeneralProgressListener(ProgressListener progressListener) Sets the optional progress listener for receiving updates about object download status, and returns this updated object so that additional method calls can be chained together.
GetObjectRequest	withKey(String key) Sets the key under which the object to be downloaded is stored.
GetObjectRequest	withMatchingETagConstraint(String eTag) Sets a single ETag constraint to this request.
GetObjectRequest	withModifiedSinceConstraint(Date date) Sets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.
GetObjectRequest	withNonmatchingETagConstraint(String eTag) Sets a single ETag constraint to this request.
GetObjectRequest	withProgressListener(ProgressListener progressListener) 已过时。 use withGeneralProgressListener(ProgressListener) instead.
GetObjectRequest	withRange(long start, long end) Sets the optional inclusive byte range within the desired object that will be downloaded by this request.
GetObjectRequest	withResponseHeaders(ResponseHeaderOverrides responseHeaders) Sets the headers to be overridden in the service response and returns this object, for method chaining.
GetObjectRequest	withUnmodifiedSinceConstraint(Date date) Sets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.
GetObjectRequest	withVersionId(String versionId) Sets the optional version ID specifying which version of the object to download and returns this object, enabling additional method calls to be chained together.

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

copyPrivateRequestParameters, getDelegationToken, getRequestClientOptions, getRequestCredentials, setDelegationToken, setRequestCredentials

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

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

构造器详细资料

GetObjectRequest

public GetObjectRequest(String bucketName,
                String key)

Constructs a new GetObjectRequest with all the required parameters.

参数:

bucketName - The name of the bucket containing the desired object.

key - The key in the specified bucket under which the object is stored.

另请参阅:

GetObjectRequest(String, String, String)

GetObjectRequest

public GetObjectRequest(String bucketName,
                String key,
                String versionId)

Constructs a new GetObjectRequest with all the required parameters.

参数:

bucketName - The name of the bucket containing the desired object.

key - The key in the specified bucket under which the object is stored.

versionId - The Amazon S3 version ID specifying a specific version of the object to download.

另请参阅:

GetObjectRequest(String, String)

方法详细资料

getBucketName

public String getBucketName()

Gets the name of the bucket containing the object to be downloaded.

返回:

The name of the bucket containing the object to be downloaded.

另请参阅:

setBucketName(String), withBucketName(String)

setBucketName

public void setBucketName(String bucketName)

Sets the name of the bucket containing the object to be downloaded.

参数:

bucketName - The name of the bucket containing the object to be downloaded.

另请参阅:

getBucketName(), withBucketName(String)

withBucketName

public GetObjectRequest withBucketName(String bucketName)

Sets the name of the bucket containing the object to be downloaded. Returns this GetObjectRequest, enabling additional method calls to be chained together.

参数:

bucketName - The name of the bucket containing the object to be downloaded.

返回:

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

另请参阅:

getBucketName(), setBucketName(String)

getKey

public String getKey()

Gets the key under which the object to be downloaded is stored.

返回:

The key under which the object to be downloaded is stored.

另请参阅:

setKey(String), withKey(String)

setKey

public void setKey(String key)

Sets the key under which the object to be downloaded is stored.

参数:

key - The key under which the object to be downloaded is stored.

另请参阅:

getKey(), withKey(String)

withKey

public GetObjectRequest withKey(String key)

Sets the key under which the object to be downloaded is stored. Returns this GetObjectRequest, enabling additional method calls to be chained together.

参数:

key - The key under which the object to be downloaded is stored.

返回:

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

另请参阅:

getKey(), setKey(String)

getVersionId

public String getVersionId()

Gets the optional version ID specifying which version of the object to download. If not specified, the most recent version will be downloaded.

Objects created before versioning was enabled or when versioning is suspended are given the default null version ID (see Constants.NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.

For more information about enabling versioning for a bucket, see SCS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

返回:

The optional version ID specifying which version of the object to download. If not specified, the most recent version will be downloaded.

另请参阅:

setVersionId(String), withVersionId(String)

setVersionId

public void setVersionId(String versionId)

Sets the optional version ID specifying which version of the object to download. If not specified, the most recent version will be downloaded.

Objects created before versioning was enabled or when versioning is suspended will be given the default null version ID (see Constants.NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.

For more information about enabling versioning for a bucket, see SCS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

参数:

versionId - The optional version ID specifying which version of the object to download.

另请参阅:

getVersionId(), withVersionId(String)

withVersionId

public GetObjectRequest withVersionId(String versionId)

Sets the optional version ID specifying which version of the object to download and returns this object, enabling additional method calls to be chained together. If not specified, the most recent version will be downloaded.

Objects created before versioning was enabled or when versioning is suspended will be given the default or null version ID (see Constants.NULL_VERSION_ID). Note that the null version ID is a valid version ID and is not the same as not having a version ID.

For more information about enabling versioning for a bucket, see SCS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest).

参数:

versionId - The optional version ID specifying which version of the object to download.

返回:

The updated request object, enabling additional method calls to be chained together.

另请参阅:

getVersionId(), setVersionId(String)

getRange

public long[] getRange()

Gets the optional inclusive byte range within the desired object that will be downloaded by this request.

The range is returned as a two element array, containing the start and end index of the byte range. If no byte range has been specified, the entire object is downloaded and this method returns null.

返回:

A two element array indicating the inclusive start index and end index within the object being downloaded by this request. Returns null if no range has been specified, and the whole object is to be downloaded.

另请参阅:

GetObjectMetadataRequest#setRange(long, long), withRange(long, long)

setRange

public void setRange(long start,
            long end)

Sets the optional inclusive byte range within the desired object that will be downloaded by this request.

The first byte in an object has position 0; as an example, the first ten bytes of an object can be downloaded by specifying a range of 0 to 9.

If no byte range is specified, this request downloads the entire object from Amazon S3.

参数:

start - The start of the inclusive byte range to download.

end - The end of the inclusive byte range to download.

另请参阅:

GetObjectMetadataRequest#getRange(), withRange(long, long)

withRange

public GetObjectRequest withRange(long start,
                         long end)

Sets the optional inclusive byte range within the desired object that will be downloaded by this request. Returns this GetObjectRequest, enabling additional method calls to be chained together.

The first byte in an object has position 0; as an example, the first ten bytes of an object can be downloaded by specifying a range of 0 to 9.

If no byte range is specified, this request downloads the entire object from Amazon S3.

参数:

start - The start of the inclusive byte range to download.

end - The end of the inclusive byte range to download.

返回:

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

另请参阅:

getRange(), setRange(long, long)

getMatchingETagConstraints

public List<String> getMatchingETagConstraints()

Gets the optional list of ETag constraints that, when present, must include a match for the object's current ETag in order for this request to be executed. Only one ETag in the list needs to match for this request to be executed by Amazon S3.

返回:

The optional list of ETag constraints that when present must include a match for the object's current ETag in order for this request to be executed.

另请参阅:

setMatchingETagConstraints(List), withMatchingETagConstraint(String)

setMatchingETagConstraints

public void setMatchingETagConstraints(List<String> eTagList)

Sets the optional list of ETag constraints that when present must include a match for the object's current ETag in order for this request to be executed. If none of the specified ETags match the object's current ETag, this request will not be executed. Only one ETag in the list needs to match for the request to be executed by Amazon S3.

参数:

eTagList - The optional list of ETag constraints that must include a match for the object's current ETag in order for this request to be executed.

另请参阅:

getMatchingETagConstraints(), withMatchingETagConstraint(String)

withMatchingETagConstraint

public GetObjectRequest withMatchingETagConstraint(String eTag)

Sets a single ETag constraint to this request. Returns this GetObjectRequest, enabling additional method calls to be chained together.

Multiple ETag constraints can be added to a request, but one must match the object's current ETag in order for this request to be executed. If none of the ETag constraints added to this request match the object's current ETag, this request will not be executed by Amazon S3.

参数:

eTag - The matching ETag constraint to add to this request.

返回:

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

另请参阅:

getMatchingETagConstraints(), setMatchingETagConstraints(List)

getNonmatchingETagConstraints

public List<String> getNonmatchingETagConstraints()

Gets the optional list of ETag constraints that when present, must not include a match for the object's current ETag in order for this request to be executed. If any entry in the non-matching ETag constraint list matches the object's current ETag, this request will not be executed by Amazon S3.

返回:

The optional list of ETag constraints that when present, must not include a match for the object's current ETag in order for this request to be executed.

另请参阅:

setNonmatchingETagConstraints(List), withNonmatchingETagConstraint(String)

setNonmatchingETagConstraints

public void setNonmatchingETagConstraints(List<String> eTagList)

Sets the optional list of ETag constraints that when present must not include a match for the object's current ETag in order for this request to be executed. If any entry in the non-matching ETag constraint list matches the object's current ETag, this request will not be executed by Amazon S3.

参数:

eTagList - The list of ETag constraints that, when present, must not include a match for the object's current ETag in order for this request to be executed.

另请参阅:

getNonmatchingETagConstraints(), withNonmatchingETagConstraint(String)

withNonmatchingETagConstraint

public GetObjectRequest withNonmatchingETagConstraint(String eTag)

Sets a single ETag constraint to this request. Returns this GetObjectRequest, enabling additional method calls to be chained together.

Multiple ETag constraints can be added to a request, but all ETag constraints must not match the object's current ETag in order for this request to be executed. If any entry in the non-matching ETag constraint list matches the object's current ETag, this request will not be executed by Amazon S3.

参数:

eTag - The non-matching ETag constraint to add to this request.

返回:

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

另请参阅:

getNonmatchingETagConstraints(), setNonmatchingETagConstraints(List)

getUnmodifiedSinceConstraint

public Date getUnmodifiedSinceConstraint()

Gets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.

返回:

The optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.

另请参阅:

setUnmodifiedSinceConstraint(Date), withUnmodifiedSinceConstraint(Date)

setUnmodifiedSinceConstraint

public void setUnmodifiedSinceConstraint(Date date)

Sets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date.

Note that Amazon S3 will ignore any dates occurring in the future.

参数:

date - The unmodified constraint that restricts this request to executing only if the object has not been modified after this date.

另请参阅:

getUnmodifiedSinceConstraint(), withUnmodifiedSinceConstraint(Date)

withUnmodifiedSinceConstraint

public GetObjectRequest withUnmodifiedSinceConstraint(Date date)

Sets the optional unmodified constraint that restricts this request to executing only if the object has not been modified after the specified date. Returns this GetObjectRequest, enabling additional method calls to be chained together.

Note that Amazon S3 will ignore any dates occurring in the future.

参数:

date - The unmodified constraint that restricts this request to executing only if the object has not been modified after this date.

返回:

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

另请参阅:

getUnmodifiedSinceConstraint(), setUnmodifiedSinceConstraint(Date)

getModifiedSinceConstraint

public Date getModifiedSinceConstraint()

Gets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.

返回:

The optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.

另请参阅:

setModifiedSinceConstraint(Date), withModifiedSinceConstraint(Date)

setModifiedSinceConstraint

public void setModifiedSinceConstraint(Date date)

Sets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date.

Note that Amazon S3 will ignore any dates occurring in the future.

参数:

date - The modified constraint that restricts this request to executing only if the object has been modified after the specified date.

另请参阅:

getModifiedSinceConstraint(), withModifiedSinceConstraint(Date)

withModifiedSinceConstraint

public GetObjectRequest withModifiedSinceConstraint(Date date)

Sets the optional modified constraint that restricts this request to executing only if the object has been modified after the specified date. Returns this GetObjectRequest, enabling additional method calls to be chained together.

Note that Amazon S3 will ignore any dates occurring in the future.

参数:

date - The modified constraint that restricts this request to executing only if the object has been modified after the specified date.

返回:

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

另请参阅:

getModifiedSinceConstraint(), setModifiedSinceConstraint(Date)

getResponseHeaders

public ResponseHeaderOverrides getResponseHeaders()

Returns the headers to be overridden in the service response.

返回:

the headers to be overridden in the service response.

setResponseHeaders

public void setResponseHeaders(ResponseHeaderOverrides responseHeaders)

Sets the headers to be overridden in the service response.

参数:

responseHeaders - The headers to be overridden in the service response.

withResponseHeaders

public GetObjectRequest withResponseHeaders(ResponseHeaderOverrides responseHeaders)

Sets the headers to be overridden in the service response and returns this object, for method chaining.

参数:

responseHeaders - The headers to be overridden in the service response.

返回:

This GetObjectRequest for method chaining.

setProgressListener

@Deprecated
public void setProgressListener(ProgressListener progressListener)

已过时。 use setGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates about object download 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 download status.

返回:

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

withProgressListener

@Deprecated
public GetObjectRequest withProgressListener(ProgressListener progressListener)

已过时。 use withGeneralProgressListener(ProgressListener) instead.

Sets the optional progress listener for receiving updates about object download 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 GetObjectRequest 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 GetObjectRequest withGeneralProgressListener(ProgressListener progressListener)

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

参数:

generalProgressListener - The new progress listener.

返回:

This updated GetObjectRequest object.