org.jclouds.openstack.v2_0.options

Class PaginationOptions

java.lang.Object

org.jclouds.http.options.BaseHttpRequestOptions

org.jclouds.openstack.v2_0.options.PaginationOptions

All Implemented Interfaces:

HttpRequestOptions

Direct Known Subclasses:

ListOptions

public class PaginationOptions
extends BaseHttpRequestOptions

Options used to control paginated results (aka list commands).

Author:

Adrian Cole

See Also:

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PaginationOptions.Builder

Field Summary

Fields inherited from class org.jclouds.http.options.BaseHttpRequestOptions

formParameters, headers, pathSuffix, payload, queryParameters

Constructor Summary

Constructors

Constructor and Description
PaginationOptions()

Method Summary

Methods

Modifier and Type	Method and Description
PaginationOptions	changesSince(Date ifModifiedSince) Only return objects changed since this time.
PaginationOptions	limit(int limit) To reduce load on the service, list operations will return a maximum of 1,000 items at a time.
PaginationOptions	marker(String marker) The marker parameter is the ID of the last item in the previous list.

Methods inherited from class org.jclouds.http.options.BaseHttpRequestOptions

buildFormParameters, buildPathSuffix, buildQueryParameters, buildRequestHeaders, buildStringPayload, equals, getFirstFormOrNull, getFirstHeaderOrNull, getFirstQueryOrNull, hashCode, replaceHeader, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

PaginationOptions

public PaginationOptions()

Method Detail

changesSince

public PaginationOptions changesSince(Date ifModifiedSince)

Only return objects changed since this time.

marker

public PaginationOptions marker(String marker)

The marker parameter is the ID of the last item in the previous list. Items are sorted by create time in descending order. When a create time is not available they are sorted by ID.

limit

public PaginationOptions limit(int limit)

To reduce load on the service, list operations will return a maximum of 1,000 items at a time. To navigate the collection, the parameters limit and offset can be set in the URI (e.g.?limit=0&offset=0). If an offset is given beyond the end of a list an empty list will be returned.

Note that list operations never return itemNotFound (404) faults.