me.jaksa

Class Unreliable

java.lang.Object

me.jaksa.Unreliable

public class Unreliable
extends Object

Utility methods to make it easier to work with unreliable components

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAILT_RETRIES

Constructor Summary

Constructors

Constructor and Description
Unreliable()

Method Summary

Modifier and Type	Method and Description
static void	keepTrying(RunnableWithException r) Performs an action until no exception is thrown.
static <T> T	keepTrying(SupplierWithException<T> s) Tries to retrieve a value until no exception is thrown.
static void	retryOn(Class exceptionClass, RunnableWithException r) Tries to execute the supplied runnable up to three times as long as the specified exception is being thrown.
static void	retryOn(Class exceptionClass, RunnableWithException r, int times) Tries to execute the supplied runnable up to the specified number of times as long as the specified exception is being thrown.
static <T> T	retryOn(Class exceptionClass, SupplierWithException<T> s) Tries to retrieve a value up to three times as long as the specified exception is being thrown.
static <T> T	retryOn(Class exceptionClass, SupplierWithException<T> s, int times) Tries to retrieve a value up to the specified number of times as long as the specified exception is being thrown.
static void	retryOn(Collection<Class> exceptionClasses, RunnableWithException r) Tries to execute the runnable up to three times as long as one of the specified exceptions is being thrown.
static void	retryOn(Collection<Class> exceptionClasses, RunnableWithException r, int times) Tries to execute the runnable up to the specified number of times as long as one of the specified exceptions is being thrown.
static <T> T	retryOn(Collection<Class> exceptionClasses, SupplierWithException<T> s) Tries to retrieve a value up to three times as long as one of the specified exceptions is being thrown.
static <T> T	retryOn(Collection<Class> exceptionClasses, SupplierWithException<T> s, int times) Tries to retrieve a value up to the specified number of times as long as one of the specified exceptions is being thrown.
static void	tenaciously(RunnableWithException r) Performs an action up to three times until no exception is thrown.
static void	tenaciously(RunnableWithException r, int times) Performs an action up to the specified number of times until no exception is thrown.
static <T> T	tenaciously(SupplierWithException<T> s) Tries to retrieve a value up to three times until no exception is thrown.
static <T> T	tenaciously(SupplierWithException<T> s, int times) Tries to retrieve a value up to the specified number of times until no exception is thrown.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAILT_RETRIES

public static final int DEFAILT_RETRIES

See Also:

Constant Field Values

Constructor Detail

Unreliable

public Unreliable()

Method Detail

keepTrying

public static void keepTrying(RunnableWithException r)

Performs an action until no exception is thrown.

Parameters:

r - the action to perform

keepTrying

public static <T> T keepTrying(SupplierWithException<T> s)

Tries to retrieve a value until no exception is thrown.

Type Parameters:

T - the type of the return value

Parameters:

s - the function to evaluate

Returns:

the value retunred by the function

tenaciously

public static void tenaciously(RunnableWithException r)

Performs an action up to three times until no exception is thrown.

Parameters:

r - the action to perform

Throws:

RuntimeException - if the action fails three times.

tenaciously

public static void tenaciously(RunnableWithException r,
                               int times)

Performs an action up to the specified number of times until no exception is thrown.

Parameters:

r - the action to perform

times - the number of times to retry

Throws:

RuntimeException - if the action fails the specified number of times.

tenaciously

public static <T> T tenaciously(SupplierWithException<T> s)

Tries to retrieve a value up to three times until no exception is thrown.

Type Parameters:

T - the type of the return value

Parameters:

s - the function to evaluate

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails three times.

tenaciously

public static <T> T tenaciously(SupplierWithException<T> s,
                                int times)

Tries to retrieve a value up to the specified number of times until no exception is thrown.

Type Parameters:

T - the type of the return value

Parameters:

s - the function to evaluate

times - the number of times to retry

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails the specified number of times.

retryOn

public static void retryOn(Class exceptionClass,
                           RunnableWithException r)

Tries to execute the supplied runnable up to three times as long as the specified exception is being thrown.

Parameters:

exceptionClass - retry only on this class of exceptions

r - the function to evaluate

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static <T> T retryOn(Class exceptionClass,
                            SupplierWithException<T> s)

Tries to retrieve a value up to three times as long as the specified exception is being thrown.

Type Parameters:

T - the type of the return value

Parameters:

exceptionClass - retry only on this class of exceptions

s - the function to evaluate

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static void retryOn(Class exceptionClass,
                           RunnableWithException r,
                           int times)

Tries to execute the supplied runnable up to the specified number of times as long as the specified exception is being thrown.

Parameters:

exceptionClass - retry only on this class of exceptions

r - the function to evaluate

times - the number of times to retry

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static <T> T retryOn(Class exceptionClass,
                            SupplierWithException<T> s,
                            int times)

Tries to retrieve a value up to the specified number of times as long as the specified exception is being thrown.

Type Parameters:

T - the type of the return value

Parameters:

exceptionClass - retry only on this class of exceptions

s - the function to evaluate

times - the maximum number of times to retry

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static void retryOn(Collection<Class> exceptionClasses,
                           RunnableWithException r)

Tries to execute the runnable up to three times as long as one of the specified exceptions is being thrown.

Parameters:

exceptionClasses - retry on any of these classes of exceptions

r - the function to evaluate

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static void retryOn(Collection<Class> exceptionClasses,
                           RunnableWithException r,
                           int times)

Tries to execute the runnable up to the specified number of times as long as one of the specified exceptions is being thrown.

Parameters:

exceptionClasses - retry on any of these classes of exceptions

r - the function to evaluate

times - the maximum number of times to retry

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static <T> T retryOn(Collection<Class> exceptionClasses,
                            SupplierWithException<T> s)

Tries to retrieve a value up to three times as long as one of the specified exceptions is being thrown.

Type Parameters:

T - the type of the return value

Parameters:

exceptionClasses - retry on any of these classes of exceptions

s - the function to evaluate

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.

retryOn

public static <T> T retryOn(Collection<Class> exceptionClasses,
                            SupplierWithException<T> s,
                            int times)

Tries to retrieve a value up to the specified number of times as long as one of the specified exceptions is being thrown.

Type Parameters:

T - the type of the return value

Parameters:

exceptionClasses - retry on any of these classes of exceptions

s - the function to evaluate

times - the maximum number of times to retry

Returns:

the value retunred by the function

Throws:

RuntimeException - if the function fails the specified number of times or a different exception is thrown.