org.mule.extension.s3.api.model

Class MultipartUploadListing

java.lang.Object

org.mule.extension.s3.api.model.MultipartUploadListing

All Implemented Interfaces:

Serializable

public class MultipartUploadListing
extends Object
implements Serializable

The ListMultipartUploadsResponse contains all the information about the ListMultipartUploads method.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MultipartUploadListing()
MultipartUploadListing(String bucketName, String keyMarker, String delimiter, String prefix, String uploadIdMarker, int maxUploads, String encodingType, boolean truncated, String nextKeyMarker, String nextUploadIdMarker, List<MultipartUpload> multipartUploads, List<String> commonPrefixes)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
String	getBucketName() Returns the name of the bucket containing the listed multipart uploads, as specified in the original request.
List<String>	getCommonPrefixes() Returns the common prefixes included in this multipart upload listing.
String	getDelimiter() Gets the delimiter parameter originally used to request this multipart upload listing, or null if no delimiter specified.
String	getEncodingType() Gets the encoding type used by Amazon S3 to encode object key names in the XML response.
String	getKeyMarker() Returns the optional key marker specified in the original request to specify where in the results to begin listing multipart uploads.
int	getMaxUploads() Returns the optional maximum number of uploads to be listed, as specified in the original request.
List<MultipartUpload>	getMultipartUploads() Returns the list of multipart uploads.
String	getNextKeyMarker() Returns the next key marker that should be used in the next request to get the next page of results.
String	getNextUploadIdMarker() Returns the next upload ID marker that should be used in the next request to get the next page of results.
String	getPrefix() Returns the prefix parameter originally used to request this multipart upload listing, or null if no prefix was specified.
String	getUploadIdMarker() Returns the optional upload ID marker specified in the original request to specify where in the results to begin listing multipart uploads.
int	hashCode()
boolean	isTruncated() Returns true if the listing is truncated, and additional requests need to be made to get more results.

Methods inherited from class java.lang.Object

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

Constructor Detail

MultipartUploadListing

public MultipartUploadListing(String bucketName,
                              String keyMarker,
                              String delimiter,
                              String prefix,
                              String uploadIdMarker,
                              int maxUploads,
                              String encodingType,
                              boolean truncated,
                              String nextKeyMarker,
                              String nextUploadIdMarker,
                              List<MultipartUpload> multipartUploads,
                              List<String> commonPrefixes)

MultipartUploadListing

public MultipartUploadListing()

Method Detail

getBucketName

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

getKeyMarker

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

getUploadIdMarker

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

getNextKeyMarker

public String 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 if isTruncated() 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.

getNextUploadIdMarker

public String 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 if isTruncated() 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.

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.

getEncodingType

public String getEncodingType()

Gets the encoding type used by Amazon S3 to encode object key names in the XML response. If you specify encodingType 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 if encodingType 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.

getMultipartUploads

public List<MultipartUpload> getMultipartUploads()

Returns the list of multipart uploads.

Returns:

The list of multipart uploads.

getCommonPrefixes

public List<String> 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"

If calling listMultipartUploads with the prefix="foo/" and the delimiter="/" on this bucket, the returned MultipartUploadListing 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.

getDelimiter

public String getDelimiter()

Gets the delimiter parameter originally used to request this multipart upload listing, or null 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.

getPrefix

public String getPrefix()

Returns the prefix parameter originally used to request this multipart upload listing, or null 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.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object