org.rnorth.ducttape.unreliables

Class Unreliables

java.lang.Object

org.rnorth.ducttape.unreliables.Unreliables

public abstract class Unreliables
extends Object

Utilities to support automatic retry of things that may fail.

Constructor Summary

Constructors

Constructor and Description
Unreliables()

Method Summary

Modifier and Type	Method and Description
static <T> T	retryUntilSuccess(int tryLimit, @NotNull Callable<T> lambda) Call a supplier repeatedly until it returns a result.
static <T> T	retryUntilSuccess(int timeout, @NotNull TimeUnit timeUnit, @NotNull Callable<T> lambda) Call a supplier repeatedly until it returns a result.
static void	retryUntilTrue(int tryLimit, @NotNull Callable<Boolean> lambda) Call a callable repeatedly until it returns true.
static void	retryUntilTrue(int timeout, @NotNull TimeUnit timeUnit, @NotNull Callable<Boolean> lambda) Call a callable repeatedly until it returns true.

Methods inherited from class java.lang.Object

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

Constructor Detail

Unreliables

public Unreliables()

Method Detail

retryUntilSuccess

public static <T> T retryUntilSuccess(int timeout,
                                      @NotNull
                                      @NotNull TimeUnit timeUnit,
                                      @NotNull
                                      @NotNull Callable<T> lambda)

Call a supplier repeatedly until it returns a result. If an exception is thrown, the call will be retried repeatedly until the timeout is hit.

Type Parameters:

T - return type of the supplier

Parameters:

timeout - how long to wait

timeUnit - time unit for time interval

lambda - supplier lambda expression (may throw checked exceptions)

Returns:

the result of the successful lambda expression call

retryUntilSuccess

public static <T> T retryUntilSuccess(int tryLimit,
                                      @NotNull
                                      @NotNull Callable<T> lambda)

Call a supplier repeatedly until it returns a result. If an exception is thrown, the call will be retried repeatedly until the retry limit is hit.

Type Parameters:

T - return type of the supplier

Parameters:

tryLimit - how many times to try calling the supplier

lambda - supplier lambda expression (may throw checked exceptions)

Returns:

the result of the successful lambda expression call

retryUntilTrue

public static void retryUntilTrue(int timeout,
                                  @NotNull
                                  @NotNull TimeUnit timeUnit,
                                  @NotNull
                                  @NotNull Callable<Boolean> lambda)

Call a callable repeatedly until it returns true. If an exception is thrown, the call will be retried repeatedly until the timeout is hit.

Parameters:

timeout - how long to wait

timeUnit - time unit for time interval

lambda - supplier lambda expression

retryUntilTrue

public static void retryUntilTrue(int tryLimit,
                                  @NotNull
                                  @NotNull Callable<Boolean> lambda)

Call a callable repeatedly until it returns true. If an exception is thrown, the call will be retried repeatedly until the timeout is hit.

Parameters:

tryLimit - how many times to try calling the supplier

lambda - supplier lambda expression