dev.failsafe

Class DelayablePolicyBuilder<S,C extends DelayablePolicyConfig<R>,R>

java.lang.Object

dev.failsafe.PolicyBuilder<S,C,R>

dev.failsafe.FailurePolicyBuilder<S,C,R>

dev.failsafe.DelayablePolicyBuilder<S,C,R>

Type Parameters:

S - self type

C - config type

R - result type

All Implemented Interfaces:

PolicyListeners<S,R>

Direct Known Subclasses:

CircuitBreakerBuilder, RetryPolicyBuilder

public abstract class DelayablePolicyBuilder<S,C extends DelayablePolicyConfig<R>,R>
extends FailurePolicyBuilder<S,C,R>

A builder of policies that can be delayed between executions.

Field Summary

Fields inherited from class dev.failsafe.PolicyBuilder

config

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DelayablePolicyBuilder(C config)

Method Summary

Modifier and Type	Method and Description
S	withDelay(Duration delay) Sets the delay to occur between execution attempts.
S	withDelayFn(ContextualSupplier<R,Duration> delayFunction) Sets the delayFunction that computes the next delay before allowing another execution.
<F extends Throwable> S	withDelayFnOn(ContextualSupplier<R,Duration> delayFunction, Class<F> exception) Sets the delayFunction that computes the next delay before allowing another execution.
S	withDelayFnWhen(ContextualSupplier<R,Duration> delayFunction, R result) Sets the delayFunction that computes the next delay before allowing another execution.

Methods inherited from class dev.failsafe.FailurePolicyBuilder

handle, handle, handle, handleIf, handleIf, handleResult, handleResultIf

Methods inherited from class dev.failsafe.PolicyBuilder

onFailure, onSuccess

Methods inherited from class java.lang.Object

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

Constructor Detail

DelayablePolicyBuilder

protected DelayablePolicyBuilder(C config)

Method Detail

withDelay

public S withDelay(Duration delay)

Sets the delay to occur between execution attempts.

Throws:

NullPointerException - if delay is null

IllegalArgumentException - if delay <= 0

withDelayFn

public S withDelayFn(ContextualSupplier<R,Duration> delayFunction)

Sets the delayFunction that computes the next delay before allowing another execution.

The delayFunction must complete quickly, not have side-effects, and always return the same result for the same input. Exceptions thrown by the delayFunction method will not be handled and will cause Failsafe's execution to abort.

Notes:

• A negative return value will cause Failsafe to use a configured fixed or backoff delay
• Any configured jitter is still applied to DelayFunction provided values
• Any configured max duration is still applied to DelayFunction provided values
• The ExecutionContext that is provided to the delayFunction may be null if the prior execution exception was manually recorded outside of a Failsafe execution.

Throws:

NullPointerException - if delayFunction is null

withDelayFnOn

public <F extends Throwable> S withDelayFnOn(ContextualSupplier<R,Duration> delayFunction,
                                             Class<F> exception)

Sets the delayFunction that computes the next delay before allowing another execution. Delays will only occur for exceptions that are assignable from the exception.

The delayFunction must complete quickly, not have side-effects, and always return the same result for the same input. Exceptions thrown by the delayFunction method will not be handled and will cause Failsafe's execution to abort.

Notes:

• A negative return value will cause Failsafe to use a configured fixed or backoff delay
• Any configured jitter is still applied to DelayFunction provided values
• Any configured max duration is still applied to DelayFunction provided values
• The ExecutionContext that is provided to the delayFunction may be null if the prior execution exception was manually recorded outside of a Failsafe execution.

Type Parameters:

F - exception type

Parameters:

delayFunction - the function to use to compute the delay before a next attempt

exception - the execution exception that is expected in order to trigger the delay

Throws:

NullPointerException - if delayFunction or exception are null

withDelayFnWhen

public S withDelayFnWhen(ContextualSupplier<R,Duration> delayFunction,
                         R result)

Sets the delayFunction that computes the next delay before allowing another execution. Delays will only occur for results that equal the result.

The delayFunction must complete quickly, not have side-effects, and always return the same result for the same input. Exceptions thrown by the delayFunction method will not be handled and will cause Failsafe's execution to abort.

Notes:

• A negative return value will cause Failsafe to use a configured fixed or backoff delay
• Any configured jitter is still applied to DelayFunction provided values
• Any configured max duration is still applied to DelayFunction provided values
• The ExecutionContext that is provided to the delayFunction may be null if the prior execution exception was manually recorded outside of a Failsafe execution.

Parameters:

delayFunction - the function to use to compute the delay before a next attempt

result - the execution result that is expected in order to trigger the delay

Throws:

NullPointerException - if delayFunction or result are null