org.jclouds.s3.domain
Interface ListBucketResponse

All Superinterfaces:

Collection<ObjectMetadata>, Iterable<ObjectMetadata>, Set<ObjectMetadata>

All Known Implementing Classes:

ListBucketResponseImpl

public interface ListBucketResponse
extends Set<ObjectMetadata>

A container that provides namespace, access control and aggregation of S3Objects

Every object stored in Amazon S3 is contained in a bucket. Buckets partition the namespace of objects stored in Amazon S3 at the top level. Within a bucket, you can use any names for your objects, but bucket names must be unique across all of Amazon S3.

Buckets are similar to Internet domain names. Just as Amazon is the only owner of the domain name Amazon.com, only one person or organization can own a bucket within Amazon S3. Once you create a uniquely named bucket in Amazon S3, you can organize and name the objects within the bucket in any way you like and the bucket will remain yours for as long as you like and as long as you have the Amazon S3 identity.

The similarities between buckets and domain names is not a coincidence there is a direct mapping between Amazon S3 buckets and subdomains of s3.amazonaws.com. Objects stored in Amazon S3 are addressable using the REST API under the domain bucketname.s3.amazonaws.com. For example, if the object homepage.html?is stored in the Amazon S3 bucket mybucket its address would be http://mybucket.s3.amazonaws.com/homepage.html?

Author:

Adrian Cole

See Also:

Method Summary

Set<String>	getCommonPrefixes() Example: if the following keys are in the bucket a/1/a a/1/b a/2/a a/2/b and prefix is set to a/ and delimiter is set to / then commonprefixes would return 1,2
String	getDelimiter() Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection.
String	getMarker()
int	getMaxKeys() The maximum number of keys you'd like to see in the response body.
String	getName() name of the Bucket
String	getNextMarker() Indicates where in the bucket to begin listing.
String	getPrefix() Limits the response to keys which begin with the indicated prefix.
boolean	isTruncated() There are more then maxKeys available

Methods inherited from interface java.util.Set

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Method Detail

getPrefix

String getPrefix()

Limits the response to keys which begin with the indicated prefix. You can use prefixes to separate a bucket into different sets of keys in a way similar to how a file system uses folders.

getNextMarker

String getNextMarker()

Indicates where in the bucket to begin listing. The list will only include keys that occur lexicographically after marker. This is convenient for pagination: To get the next page of results use the last key of the current page as the marker.

getMarker

String getMarker()

getMaxKeys

int getMaxKeys()

The maximum number of keys you'd like to see in the response body. The server might return fewer than this many keys, but will not return more.

isTruncated

boolean isTruncated()

There are more then maxKeys available

getDelimiter

String getDelimiter()

Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere in the response.

getCommonPrefixes

Set<String> getCommonPrefixes()

Example:

if the following keys are in the bucket

a/1/a
a/1/b
a/2/a
a/2/b

and prefix is set to a/ and delimiter is set to / then commonprefixes would return 1,2

See Also:

ListBucketOptions.getPrefix()

getName

String getName()

name of the Bucket