org.springframework.retry.backoff

Class UniformRandomBackOffPolicy

java.lang.Object

org.springframework.retry.backoff.StatelessBackOffPolicy

org.springframework.retry.backoff.UniformRandomBackOffPolicy

All Implemented Interfaces:

BackOffPolicy, SleepingBackOffPolicy<UniformRandomBackOffPolicy>

public class UniformRandomBackOffPolicy
extends StatelessBackOffPolicy
implements SleepingBackOffPolicy<UniformRandomBackOffPolicy>

Implementation of BackOffPolicy that pauses for a random period of time before continuing. A pause is implemented using Sleeper.sleep(long).

setMinBackOffPeriod(long) is thread-safe and it is safe to call setMaxBackOffPeriod(long) during execution from multiple threads, however this may cause a single retry operation to have pauses of different intervals.

Field Summary

Fields

Modifier and Type	Field and Description
private static long	DEFAULT_BACK_OFF_MAX_PERIOD Default max back off period - 1500ms.
private static long	DEFAULT_BACK_OFF_MIN_PERIOD Default min back off period - 500ms.
private long	maxBackOffPeriod
private long	minBackOffPeriod
private java.util.Random	random
private Sleeper	sleeper

Constructor Summary

Constructors

Constructor and Description
UniformRandomBackOffPolicy()

Method Summary

Modifier and Type	Method and Description
protected void	doBackOff() Pause for the setMinBackOffPeriod(long).
long	getMaxBackOffPeriod() The maximum backoff period in milliseconds.
long	getMinBackOffPeriod() The minimum backoff period in milliseconds.
void	setMaxBackOffPeriod(long backOffPeriod) Set the maximum back off period in milliseconds.
void	setMinBackOffPeriod(long backOffPeriod) Set the minimum back off period in milliseconds.
void	setSleeper(Sleeper sleeper) Public setter for the Sleeper strategy.
java.lang.String	toString()
UniformRandomBackOffPolicy	withSleeper(Sleeper sleeper) Clone the policy and return a new policy which uses the passed sleeper.

Methods inherited from class org.springframework.retry.backoff.StatelessBackOffPolicy

backOff, start

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.retry.backoff.BackOffPolicy

backOff, start

Field Detail

DEFAULT_BACK_OFF_MIN_PERIOD

private static final long DEFAULT_BACK_OFF_MIN_PERIOD

Default min back off period - 500ms.

See Also:

Constant Field Values

DEFAULT_BACK_OFF_MAX_PERIOD

private static final long DEFAULT_BACK_OFF_MAX_PERIOD

Default max back off period - 1500ms.

See Also:

Constant Field Values

minBackOffPeriod

private volatile long minBackOffPeriod

maxBackOffPeriod

private volatile long maxBackOffPeriod

random

private java.util.Random random

sleeper

private Sleeper sleeper

Constructor Detail

UniformRandomBackOffPolicy

public UniformRandomBackOffPolicy()

Method Detail

withSleeper

public UniformRandomBackOffPolicy withSleeper(Sleeper sleeper)

Description copied from interface: SleepingBackOffPolicy

Clone the policy and return a new policy which uses the passed sleeper.

Specified by:

withSleeper in interface SleepingBackOffPolicy<UniformRandomBackOffPolicy>

Parameters:

sleeper - Target to be invoked any time the backoff policy sleeps

Returns:

a clone of this policy which will have all of its backoff sleeps routed into the passed sleeper

setSleeper

public void setSleeper(Sleeper sleeper)

Public setter for the Sleeper strategy.

Parameters:

sleeper - the sleeper to set defaults to ThreadWaitSleeper.

setMinBackOffPeriod

public void setMinBackOffPeriod(long backOffPeriod)

Set the minimum back off period in milliseconds. Cannot be < 1. Default value is 500ms.

getMinBackOffPeriod

public long getMinBackOffPeriod()

The minimum backoff period in milliseconds.

Returns:

the backoff period

setMaxBackOffPeriod

public void setMaxBackOffPeriod(long backOffPeriod)

Set the maximum back off period in milliseconds. Cannot be < 1. Default value is 1500ms.

getMaxBackOffPeriod

public long getMaxBackOffPeriod()

The maximum backoff period in milliseconds.

Returns:

the backoff period

doBackOff

protected void doBackOff()
                  throws BackOffInterruptedException

Pause for the setMinBackOffPeriod(long).

Specified by:

doBackOff in class StatelessBackOffPolicy

Throws:

BackOffInterruptedException - if interrupted during sleep.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object