net.jodah.recurrent

Class AsyncRecurrent

java.lang.Object

net.jodah.recurrent.AsyncRecurrent

public class AsyncRecurrent
extends Object

Performs asynchronous executions with retries according to a RetryPolicy.

Method Summary

Modifier and Type	Method and Description
<T> CompletableFuture<T>	future(Callable<CompletableFuture<T>> callable) Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded.
<T> CompletableFuture<T>	future(ContextualCallable<CompletableFuture<T>> callable) Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded.
<T> CompletableFuture<T>	futureAsync(AsyncCallable<CompletableFuture<T>> callable) Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded.
<T> RecurrentFuture<T>	get(Callable<T> callable) Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded.
<T> RecurrentFuture<T>	get(ContextualCallable<T> callable) Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded.
<T> RecurrentFuture<T>	getAsync(AsyncCallable<T> callable) Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded.
RecurrentFuture<Void>	run(CheckedRunnable runnable) Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded.
RecurrentFuture<Void>	run(ContextualRunnable runnable) Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded.
RecurrentFuture<Void>	runAsync(AsyncRunnable runnable) Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded.
<T extends Listeners<?>> AsyncRecurrent	with(T listeners) Configures the listeners to be called as execution events occur.

Methods inherited from class java.lang.Object

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

Method Detail

get

public <T> RecurrentFuture<T> get(Callable<T> callable)

Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded.

Throws:

NullPointerException - if the callable is null

get

public <T> RecurrentFuture<T> get(ContextualCallable<T> callable)

Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded.

Throws:

NullPointerException - if the callable is null

getAsync

public <T> RecurrentFuture<T> getAsync(AsyncCallable<T> callable)

Executes the callable asynchronously until a successful result is returned or the configured RetryPolicy is exceeded. This method is intended for integration with asynchronous code. Retries must be manually scheduled via one of the AsyncExecution.retry methods.

Throws:

NullPointerException - if the callable is null

run

public RecurrentFuture<Void> run(CheckedRunnable runnable)

Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded.

Throws:

NullPointerException - if the runnable is null

run

public RecurrentFuture<Void> run(ContextualRunnable runnable)

Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded.

Throws:

NullPointerException - if the runnable is null

runAsync

public RecurrentFuture<Void> runAsync(AsyncRunnable runnable)

Executes the runnable asynchronously until successful or until the configured RetryPolicy is exceeded. This method is intended for integration with asynchronous code. Retries must be manually scheduled via one of the AsyncExecution.retry methods.

Throws:

NullPointerException - if the runnable is null

future

public <T> CompletableFuture<T> future(Callable<CompletableFuture<T>> callable)

Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded.

Supported on Java 8 and above.

Throws:

NullPointerException - if the callable is null

future

public <T> CompletableFuture<T> future(ContextualCallable<CompletableFuture<T>> callable)

Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded.

Supported on Java 8 and above.

Throws:

NullPointerException - if the callable is null

futureAsync

public <T> CompletableFuture<T> futureAsync(AsyncCallable<CompletableFuture<T>> callable)

Executes the callable asynchronously until the resulting future is successfully completed or the configured RetryPolicy is exceeded. This method is intended for integration with asynchronous code. Retries must be manually scheduled via one of the AsyncExecution.retry methods.

Supported on Java 8 and above.

Throws:

NullPointerException - if the callable is null

with

public <T extends Listeners<?>> AsyncRecurrent with(T listeners)

Configures the listeners to be called as execution events occur.