Class MultipartUploadListing
- All Implemented Interfaces:
Serializable
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionReturns the name of the bucket containing the listed multipart uploads, as specified in the original request.Returns the common prefixes included in this multipart upload listing.Gets the delimiter parameter originally used to request this multipart upload listing, ornull
if no delimiter specified.Gets the encoding type used by Amazon S3 to encode object key names in the XML response.Returns the optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.int
Returns the optional maximum number of uploads to be listed, as specified in the original request.Returns the list of multipart uploads.Returns the next key marker that should be used in the next request to get the next page of results.Returns the next upload ID marker that should be used in the next request to get the next page of results.Returns the prefix parameter originally used to request this multipart upload listing, ornull
if no prefix was specified.Returns the optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.boolean
Returns true if the listing is truncated, and additional requests need to be made to get more results.void
setBucketName
(String bucketName) Sets the name of the bucket containing the listed multipart uploads, as specified in the original request.void
setCommonPrefixes
(List<String> commonPrefixes) For internal use only.void
setDelimiter
(String delimiter) For internal use only.void
setEncodingType
(String encodingType) For internal use only.void
setKeyMarker
(String keyMarker) Sets the optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.void
setMaxUploads
(int maxUploads) Sets the optional maximum number of uploads to be listed, as specified in the original request.void
setMultipartUploads
(List<MultipartUpload> multipartUploads) Sets the list of multipart uploads.void
setNextKeyMarker
(String nextKeyMarker) Sets the next key marker that should be used in the next request to get the next page of results.void
setNextUploadIdMarker
(String nextUploadIdMarker) Sets the next upload ID marker that should be used in the next request to get the next page of results.void
For internal use only.void
setTruncated
(boolean isTruncated) Sets whether this listing is truncated, and additional requests need to be made to get more results.void
setUploadIdMarker
(String uploadIdMarker) Sets the optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.
-
Constructor Details
-
MultipartUploadListing
public MultipartUploadListing()
-
-
Method Details
-
getBucketName
Returns the name of the bucket containing the listed multipart uploads, as specified in the original request.- Returns:
- The name of the bucket containing the listed multipart uploads, as specified in the original request.
-
setBucketName
Sets the name of the bucket containing the listed multipart uploads, as specified in the original request.- Parameters:
bucketName
- The name of the bucket containing the listed multipart uploads, as specified in the original request.
-
getKeyMarker
Returns the optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.- Returns:
- The optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.
-
setKeyMarker
Sets the optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.- Parameters:
keyMarker
- The optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.
-
getUploadIdMarker
Returns the optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.- Returns:
- The optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.
-
setUploadIdMarker
Sets the optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.- Parameters:
uploadIdMarker
- The optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.
-
getNextKeyMarker
Returns the next key marker that should be used in the next request to get the next page of results. This value is only valid ifisTruncated()
indicates this listing is truncated.- Returns:
- the next key marker that should be used in the next request to
get the next page of results. This value is only valid if
isTruncated()
indicates this listing is truncated.
-
setNextKeyMarker
Sets the next key marker that should be used in the next request to get the next page of results.- Parameters:
nextKeyMarker
- the next key marker that should be used in the next request to get the next page of results.
-
getNextUploadIdMarker
Returns the next upload ID marker that should be used in the next request to get the next page of results. This value is only valid ifisTruncated()
indicates this listing is truncated.- Returns:
- the next upload ID marker that should be used in the next request to get the next page of results.
-
setNextUploadIdMarker
Sets the next upload ID marker that should be used in the next request to get the next page of results.- Parameters:
nextUploadIdMarker
- The next upload ID marker that should be used in the next request to get the next page of results.
-
getMaxUploads
public int getMaxUploads()Returns the optional maximum number of uploads to be listed, as specified in the original request.- Returns:
- The optional maximum number of uploads to be listed, as specified in the original request.
-
setMaxUploads
public void setMaxUploads(int maxUploads) Sets the optional maximum number of uploads to be listed, as specified in the original request.- Parameters:
maxUploads
- The optional maximum number of uploads to be listed, as specified in the original request.
-
getEncodingType
Gets the encoding type used by Amazon S3 to encode object key names in the XML response. If you specifyencodingType
request parameter, Amazon S3 includes this element in the response, and returns encoded key name values in the following response elements:Delimiter, KeyMarker, Prefix, NextKeyMarker, Key
.- Returns:
Null
ifencodingType
is not specified in the request parameter.
-
setEncodingType
For internal use only. Sets the encoding type used by Amazon S3 to encode object key names in the XML response.- Parameters:
encodingType
-Null
ifencodingType
is not specified in the request parameter.
-
isTruncated
public boolean isTruncated()Returns true if the listing is truncated, and additional requests need to be made to get more results.- Returns:
- true if the listing is truncated, and additional requests need to be made to get more results.
-
setTruncated
public void setTruncated(boolean isTruncated) Sets whether this listing is truncated, and additional requests need to be made to get more results.- Parameters:
isTruncated
- true if the listing is truncated, and additional requests need to be made to get more results.
-
getMultipartUploads
Returns the list of multipart uploads.- Returns:
- The list of multipart uploads.
-
setMultipartUploads
Sets the list of multipart uploads.- Parameters:
multipartUploads
- The list of multipart uploads.
-
getCommonPrefixes
Returns the common prefixes included in this multipart upload listing. Common prefixes are only present if a delimiter was specified in the original request.
Each common prefix represents a set of keys in the S3 bucket that have been condensed and omitted from the multipart upload listing results. This allows applications to organize and browse their multipart uploads hierarchically, similar to how a file system organizes files into directories.
For example, consider a bucket that contains the following keys currently involved in multipart uploads:
- "foo/bar/baz"
- "foo/bar/bash"
- "foo/bar/bang"
- "foo/boo"
listMultipartUploads
with the prefix="foo/" and the delimiter="/" on this bucket, the returnedMultipartUploadListing
will contain one entry in the common prefixes list ("foo/bar/") and none of the uploads for the keys beginning with that common prefix will be included in the multipart upload list.- Returns:
- The list of common prefixes included in this multipart object listing, which might be an empty list if no common prefixes were found.
-
setCommonPrefixes
For internal use only. Sets the common prefixes for this multipart upload listing, representing the uploads for key prefixes that were rolled up because of the request's delimiter parameter.- Parameters:
commonPrefixes
- The common prefixes for this multipart upload listing.
-
getDelimiter
Gets the delimiter parameter originally used to request this multipart upload listing, ornull
if no delimiter specified.The delimiter value allows callers to condense multipart uploads for keys with common prefixes. For example, if a caller specifies a delimiter of "/" (a commonly used value for delimiter), any multipart uploads for keys that contain a common prefix between the start of the key and the first occurrence of "/" will not be included in the list of multipart uploads. Instead, the common prefixes list will have one entry for the common prefix.
- Returns:
- The delimiter parameter originally used to request this multipart
upload listing. Returns
null
if no delimiter was specified.
-
setDelimiter
For internal use only. Sets the delimiter parameter originally used to request this multipart upload listing.- Parameters:
delimiter
- The delimiter parameter originally used to request this multipart upload listing.
-
getPrefix
Returns the prefix parameter originally used to request this multipart upload listing, ornull
if no prefix was specified. All objects and common prefixes included in this multipart upload listing start with the specified prefix.- Returns:
- The prefix parameter originally used to request this multipart upload
listing. Returns
null
if no prefix was specified.
-
setPrefix
For internal use only. Sets the prefix parameter originally used to request this multipart upload listing.- Parameters:
prefix
- The prefix parameter originally used to request this multipart upload listing.
-