com.couchbase.client.java.util.retry

Class RetryWithDelayHandler

java.lang.Object

com.couchbase.client.java.util.retry.RetryWithDelayHandler

All Implemented Interfaces:

Func1<com.couchbase.client.core.lang.Tuple2<Integer,Throwable>,Observable<?>>, Function

@InterfaceStability.Experimental
 @InterfaceAudience.Public
public class RetryWithDelayHandler
extends Object
implements Func1<com.couchbase.client.core.lang.Tuple2<Integer,Throwable>,Observable<?>>

A class that allows to produce a “retry” delay depending on the number of retry attempts. The number of retries is bounded by a maximum number of attempts.

Since:

2.1

See Also:

how to wrap an Observable with this behavior, how to chain this behavior into an Observable's retryWhen operation., how to construct a RetryWhenFunction in a fluent manner.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	maxAttempts
protected Scheduler	optionalScheduler
protected com.couchbase.client.core.time.Delay	retryDelay
protected Func1<Throwable,Boolean>	stoppingErrorFilter

Constructor Summary

Constructors

Constructor and Description
RetryWithDelayHandler(int maxAttempts, com.couchbase.client.core.time.Delay retryDelay) Construct a retry handler that will retry on all errors.
RetryWithDelayHandler(int maxAttempts, com.couchbase.client.core.time.Delay retryDelay, Func1<Throwable,Boolean> stoppingErrorFilter) Construct a retry handler that will retry on most errors but will stop on specific errors.
RetryWithDelayHandler(int maxAttempts, com.couchbase.client.core.time.Delay retryDelay, Func1<Throwable,Boolean> stoppingErrorFilter, Scheduler scheduler) Protected constructor that also allows to set a Scheduler for the delay, especially useful for tests.

Method Summary

Modifier and Type	Method and Description
Observable<?>	call(com.couchbase.client.core.lang.Tuple2<Integer,Throwable> attemptError)
protected static String	messageForMaxAttempts(long reachedAfterNRetries)

Methods inherited from class java.lang.Object

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

Field Detail

maxAttempts

protected final int maxAttempts

retryDelay

protected final com.couchbase.client.core.time.Delay retryDelay

stoppingErrorFilter

protected final Func1<Throwable,Boolean> stoppingErrorFilter

optionalScheduler

protected final Scheduler optionalScheduler

Constructor Detail

RetryWithDelayHandler

public RetryWithDelayHandler(int maxAttempts,
                             com.couchbase.client.core.time.Delay retryDelay)

Construct a retry handler that will retry on all errors.

Parameters:

maxAttempts - the maximum number of retries before a CannotRetryException is thrown.

retryDelay - the Delay to apply between each retry (can grow, eg. by using ExponentialDelay).

RetryWithDelayHandler

public RetryWithDelayHandler(int maxAttempts,
                             com.couchbase.client.core.time.Delay retryDelay,
                             Func1<Throwable,Boolean> stoppingErrorFilter)

Construct a retry handler that will retry on most errors but will stop on specific errors.

Parameters:

maxAttempts - the maximum number of retries before a CannotRetryException is thrown.

retryDelay - the Delay to apply between each retry (can grow, eg. by using ExponentialDelay).

stoppingErrorFilter - a predicate that determine if an error must stop the retry cycle (when true), in which case said error is cascaded down.

RetryWithDelayHandler

public RetryWithDelayHandler(int maxAttempts,
                             com.couchbase.client.core.time.Delay retryDelay,
                             Func1<Throwable,Boolean> stoppingErrorFilter,
                             Scheduler scheduler)

Protected constructor that also allows to set a Scheduler for the delay, especially useful for tests.

Method Detail

messageForMaxAttempts

protected static String messageForMaxAttempts(long reachedAfterNRetries)

call

public Observable<?> call(com.couchbase.client.core.lang.Tuple2<Integer,Throwable> attemptError)

Specified by:

call in interface Func1<com.couchbase.client.core.lang.Tuple2<Integer,Throwable>,Observable<?>>