org.jclouds.s3.options
Class ListBucketOptions

java.lang.Object
  extended by org.jclouds.http.options.BaseHttpRequestOptions
      extended by org.jclouds.s3.options.ListBucketOptions
All Implemented Interfaces:
HttpRequestOptions

public class ListBucketOptions
extends BaseHttpRequestOptions

Contains options supported in the REST API for the GET bucket operation.

Usage

The recommended way to instantiate a GetBucketOptions object is to statically import GetBucketOptions.Builder.* and invoke a static creation method followed by an instance mutator (if needed):

import static org.jclouds.s3.commands.options.GetBucketOptions.Builder.*

S3Client connection = // get connection Future bucket = connection.listBucket("bucketName",withPrefix("home/users").maxKeys(1000));

Author:
Adrian Cole
See Also:

Nested Class Summary
static class ListBucketOptions.Builder
           
 
Field Summary
static ListBucketOptions NONE
           
 
Fields inherited from class org.jclouds.http.options.BaseHttpRequestOptions
formParameters, headers, matrixParameters, pathSuffix, payload, queryParameters
 
Constructor Summary
ListBucketOptions()
           
 
Method Summary
 ListBucketOptions afterMarker(String marker)
          Indicates where in the bucket to begin listing.
 ListBucketOptions delimiter(String delimiter)
          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 getDelimiter()
           
 String getMarker()
           
 Integer getMaxResults()
           
 String getPrefix()
           
 ListBucketOptions maxResults(int maxKeys)
          The maximum number of keys you'd like to see in the response body.
 ListBucketOptions withPrefix(String prefix)
          Limits the response to keys which begin with the indicated prefix.
 
Methods inherited from class org.jclouds.http.options.BaseHttpRequestOptions
buildFormParameters, buildMatrixParameters, buildPathSuffix, buildQueryParameters, buildRequestHeaders, buildStringPayload, equals, getFirstFormOrNull, getFirstHeaderOrNull, getFirstMatrixOrNull, getFirstQueryOrNull, hashCode, replaceHeader, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

NONE

public static final ListBucketOptions NONE
Constructor Detail

ListBucketOptions

public ListBucketOptions()
Method Detail

withPrefix

public ListBucketOptions withPrefix(String prefix)
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.


getPrefix

public String getPrefix()

afterMarker

public ListBucketOptions afterMarker(String marker)
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

public String getMarker()

maxResults

public ListBucketOptions maxResults(int maxKeys)
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.


getMaxResults

public Integer getMaxResults()

delimiter

public ListBucketOptions delimiter(String delimiter)
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.


getDelimiter

public String getDelimiter()


Copyright © 2009-2011 jclouds. All Rights Reserved.