com.couchbase.client.java.util

Class TransparentReplicaGetHelper

java.lang.Object

com.couchbase.client.java.util.TransparentReplicaGetHelper

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public class TransparentReplicaGetHelper
extends Object

The TransparentReplicaGetHelper abstracts common logic to first grab the active document and if that fails tries all available replicas and returns the first result.

NOTE: Using these APIs is eventually consistent meaning that you cannot rely on a previous successful mutation to a document be reflected in the result. Use this API only if you favor availability over consistency on the read path.

Constructor Summary

Constructors

Constructor and Description
TransparentReplicaGetHelper()

Method Summary

Modifier and Type	Method and Description
rx.Single<JsonDocument>	getFirstPrimaryOrReplica(String id, Bucket bucket) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (using the environments KV timeout for both primary and replica).
rx.Single<JsonDocument>	getFirstPrimaryOrReplica(String id, Bucket bucket, long timeout) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with a custom timeout value applied to both primary and replica).
rx.Single<JsonDocument>	getFirstPrimaryOrReplica(String id, Bucket bucket, long primaryTimeout, long replicaTimeout) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with custom primary and replica timeout values).
static <D extends Document<?>> rx.Single<D>	getFirstPrimaryOrReplica(String id, Class<D> target, Bucket bucket) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (using the environments KV timeout for both primary and replica).
static <D extends Document<?>> rx.Single<D>	getFirstPrimaryOrReplica(String id, Class<D> target, Bucket bucket, long timeout) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with a custom timeout value applied to both primary and replica).
static <D extends Document<?>> rx.Single<D>	getFirstPrimaryOrReplica(String id, Class<D> target, Bucket bucket, long primaryTimeout, long replicaTimeout) Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransparentReplicaGetHelper

public TransparentReplicaGetHelper()

Method Detail

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public rx.Single<JsonDocument> getFirstPrimaryOrReplica(String id,
                                                                                                                    Bucket bucket,
                                                                                                                    long primaryTimeout,
                                                                                                                    long replicaTimeout)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with custom primary and replica timeout values).

Parameters:

id - the document ID to fetch.

bucket - the bucket to use when fetching the doc.

primaryTimeout - the timeout to use in MS when fetching the primary.

replicaTimeout - the timeout to use in MS when subsequently fetching the replicas and primary.

Returns:

an Single with either 0 or 1 JsonDocument.

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public rx.Single<JsonDocument> getFirstPrimaryOrReplica(String id,
                                                                                                                    Bucket bucket,
                                                                                                                    long timeout)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with a custom timeout value applied to both primary and replica).

Parameters:

id - the document ID to fetch.

bucket - the bucket to use when fetching the doc.

timeout - the timeout to use for both primary and replica fetches (separately)

Returns:

an Single with either 0 or 1 JsonDocument.

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public rx.Single<JsonDocument> getFirstPrimaryOrReplica(String id,
                                                                                                                    Bucket bucket)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (using the environments KV timeout for both primary and replica).

Parameters:

id - the document ID to fetch.

bucket - the bucket to use when fetching the doc.

Returns:

an Single with either 0 or 1 JsonDocument.

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public static <D extends Document<?>> rx.Single<D> getFirstPrimaryOrReplica(String id,
                                                                                                                                        Class<D> target,
                                                                                                                                        Bucket bucket)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (using the environments KV timeout for both primary and replica).

Parameters:

id - the document ID to fetch.

target - the custom document type to use.

bucket - the bucket to use when fetching the doc.

Returns:

@return a Single with either 0 or 1 Document.

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public static <D extends Document<?>> rx.Single<D> getFirstPrimaryOrReplica(String id,
                                                                                                                                        Class<D> target,
                                                                                                                                        Bucket bucket,
                                                                                                                                        long timeout)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them (with a custom timeout value applied to both primary and replica).

Parameters:

id - the document ID to fetch.

target - the custom document type to use.

bucket - the bucket to use when fetching the doc.

timeout - the timeout to use for both primary and replica fetches (separately)

Returns:

@return a Single with either 0 or 1 Document.

getFirstPrimaryOrReplica

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public static <D extends Document<?>> rx.Single<D> getFirstPrimaryOrReplica(String id,
                                                                                                                                        Class<D> target,
                                                                                                                                        Bucket bucket,
                                                                                                                                        long primaryTimeout,
                                                                                                                                        long replicaTimeout)

Asynchronously fetch the document from the primary and if that operations fails try all the replicas and return the first document that comes back from them.

Parameters:

id - the document ID to fetch.

target - the custom document type to use.

bucket - the bucket to use when fetching the doc.

primaryTimeout - the timeout to use in MS when fetching the primary.

replicaTimeout - the timeout to use in MS when subsequently fetching the replicas and primary.

Returns:

@return a Single with either 0 or 1 Document.