org.rnorth.ducttape.inconsistents

Class Inconsistents

java.lang.Object

org.rnorth.ducttape.inconsistents.Inconsistents

public class Inconsistents
extends Object

Utility for calling a supplier that may take time to stabilise on a final result.

Constructor Summary

Constructors

Constructor and Description
Inconsistents()

Method Summary

Modifier and Type	Method and Description
static <T> T	retryUntilConsistent(int consistentTime, int totalTimeout, @NotNull TimeUnit timeUnit, @NotNull Callable<T> lambda) Retry invocation of a supplier repeatedly until it returns a consistent result for a sufficient time period.

Methods inherited from class java.lang.Object

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

Constructor Detail

Inconsistents

public Inconsistents()

Method Detail

retryUntilConsistent

public static <T> T retryUntilConsistent(int consistentTime,
                                         int totalTimeout,
                                         @NotNull
                                         @NotNull TimeUnit timeUnit,
                                         @NotNull
                                         @NotNull Callable<T> lambda)

Retry invocation of a supplier repeatedly until it returns a consistent result for a sufficient time period. This is intended for calls to components that take an unknown amount of time to stabilise, and where repeated checks are the only way to detect that a stable state has been reached.

Type Parameters:

T - the return type of the UnreliableSupplier

Parameters:

consistentTime - how long the result should be consistent for before it is returned

totalTimeout - how long in total to wait for stabilisation to occur

timeUnit - time unit for time intervals

lambda - an UnreliableSupplier which should be called

Returns:

the result of the supplier if it returned a consistent result for the specified interval