io.orchestrate.client

Class KvListResource

java.lang.Object

io.orchestrate.client.KvListResource

public class KvListResource
extends java.lang.Object

The resource for the KV list features in the Orchestrate API.

Field Summary

Fields

Modifier and Type	Field and Description
protected OrchestrateClient	client The Orchestrate client to make requests with.
protected JacksonMapper	jacksonMapper
protected com.fasterxml.jackson.databind.ObjectMapper	mapper The object mapper used to deserialize JSON responses.

Method Summary

Methods

Modifier and Type	Method and Description
<T> OrchestrateRequest<KvList<T>>	get(java.lang.Class<T> clazz) Fetch a paginated, lexicographically ordered list of items contained in a collection.
KvListResource	inclusive() Deprecated. Use startKey(String, boolean)
KvListResource	inclusive(boolean inclusive) Deprecated. Use startKey(String, boolean)
KvListResource	limit(int limit) The number of results to return.
KvListResource	startKey(java.lang.String startKey) The start (non-inclusive) of the key range to paginate from including the specified value if it exists.
KvListResource	startKey(java.lang.String startKey, boolean inclusive) The start of the key range to paginate from including the specified value if it exists.
KvListResource	stopKey(java.lang.String stopKey) The end (non-inclusive) of the key range to paginate from including the specified value if it exists.
KvListResource	stopKey(java.lang.String stopKey, boolean inclusive) The end of the key range to paginate from including the specified value if it exists.
protected byte[]	toJsonBytes(java.lang.Object value)
protected com.fasterxml.jackson.databind.JsonNode	toJsonNode(org.glassfish.grizzly.http.HttpContent response)
protected <T> KvObject<T>	toKvObject(org.glassfish.grizzly.http.HttpContent response, java.lang.String collection, java.lang.String key, java.lang.Class<T> clazz)
protected <T> KvObject<T>	toKvObject(com.fasterxml.jackson.databind.JsonNode result, java.lang.Class<T> clazz)
KvListResource	withValues(boolean withValues) If withValues is true then the KV objects being listed will be retrieved with their values.

Methods inherited from class java.lang.Object

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

Field Detail

client

protected final OrchestrateClient client

The Orchestrate client to make requests with.

mapper

protected final com.fasterxml.jackson.databind.ObjectMapper mapper

The object mapper used to deserialize JSON responses.

jacksonMapper

protected final JacksonMapper jacksonMapper

Method Detail

get

public <T> OrchestrateRequest<KvList<T>> get(@NonNull
                                    java.lang.Class<T> clazz)

Fetch a paginated, lexicographically ordered list of items contained in a collection.

Usage:

 KvList<String> objects =
         client.listCollection("someCollection")
               .limit(10)
               .get(String.class)
               .get();
 
 

Type Parameters:

T - The type to deserialize the result of the request to.

Parameters:

clazz - Type information for marshalling objects at runtime.

Returns:

The prepared get request.

inclusive

public KvListResource inclusive()

Deprecated. Use startKey(String, boolean)

Add the 'startKey' to the result set, equivalent to:

 this.inclusive(Boolean.TRUE);
 
 

Returns:

The KV list resource.

See Also:

inclusive(boolean)

inclusive

public KvListResource inclusive(boolean inclusive)

Deprecated. Use startKey(String, boolean)

If inclusive is true the 'startKey' will be included in the result set.

Parameters:

inclusive - Whether to include the 'startKey' in the result set.

Returns:

The KV list resource.

limit

public KvListResource limit(int limit)

The number of results to return.

Parameters:

limit - The number of KV objects to retrieve.

Returns:

The KV list resource.

startKey

public KvListResource startKey(java.lang.String startKey)

The start (non-inclusive) of the key range to paginate from including the specified value if it exists.

Parameters:

startKey - The start of the key range to paginate from.

Returns:

The KV list resource.

startKey

public KvListResource startKey(java.lang.String startKey,
                      boolean inclusive)

The start of the key range to paginate from including the specified value if it exists.

Parameters:

startKey - The start of the key range to paginate from.

Returns:

The KV list resource.

stopKey

public KvListResource stopKey(java.lang.String stopKey)

The end (non-inclusive) of the key range to paginate from including the specified value if it exists.

Parameters:

stopKey - The end of the key range to paginate from.

Returns:

The KV list resource.

stopKey

public KvListResource stopKey(java.lang.String stopKey,
                     boolean inclusive)

The end of the key range to paginate from including the specified value if it exists.

Parameters:

stopKey - The end of the key range to paginate from.

inclusive - true to include the specified key in the results, false to stop just before it.

Returns:

The KV list resource.

withValues

public KvListResource withValues(boolean withValues)

If withValues is true then the KV objects being listed will be retrieved with their values. Defaults to true.

Parameters:

withValues - The setting for whether to retrieve KV values.

Returns:

The KV list resource.

toJsonBytes

protected byte[] toJsonBytes(java.lang.Object value)

toJsonNode

protected com.fasterxml.jackson.databind.JsonNode toJsonNode(org.glassfish.grizzly.http.HttpContent response)
                                                      throws java.io.IOException

Throws:

java.io.IOException

toKvObject

protected <T> KvObject<T> toKvObject(com.fasterxml.jackson.databind.JsonNode result,
                         java.lang.Class<T> clazz)
                          throws java.io.IOException

Throws:

java.io.IOException

toKvObject

protected <T> KvObject<T> toKvObject(org.glassfish.grizzly.http.HttpContent response,
                         java.lang.String collection,
                         java.lang.String key,
                         java.lang.Class<T> clazz)
                          throws java.io.IOException

Throws:

java.io.IOException