io.atomix.utils.concurrent

Class Futures

java.lang.Object

io.atomix.utils.concurrent.Futures

public final class Futures
extends Object

Utilities for creating completed and exceptional futures.

Author:

Jordan Halterman

Constructor Summary

Constructors

Constructor and Description
Futures()

Method Summary

Modifier and Type	Method and Description
static <T> CompletableFuture<T>	asyncFuture(CompletableFuture<T> future, Executor executor) Returns a wrapped future that will be completed on the given executor.
static <T> CompletableFuture<T>	completedFuture(T result) Creates a future that is synchronously completed.
static <T> CompletableFuture<T>	completedFutureAsync(T result, Executor executor) Creates a future that is asynchronously completed.
static <T> CompletableFuture<T>	exceptionalFuture(Throwable t) Creates a future that is synchronously completed exceptionally.
static <T> CompletableFuture<T>	exceptionalFutureAsync(Throwable t, Executor executor) Creates a future that is asynchronously completed exceptionally.
static <T> CompletableFuture<T>	orderedFuture() Returns a future that completes callbacks in add order.

Methods inherited from class java.lang.Object

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

Constructor Detail

Futures

public Futures()

Method Detail

completedFuture

public static <T> CompletableFuture<T> completedFuture(T result)

Creates a future that is synchronously completed.

Parameters:

result - The future result.

Returns:

The completed future.

completedFutureAsync

public static <T> CompletableFuture<T> completedFutureAsync(T result,
                                                            Executor executor)

Creates a future that is asynchronously completed.

Parameters:

result - The future result.

executor - The executor on which to complete the future.

Returns:

The completed future.

exceptionalFuture

public static <T> CompletableFuture<T> exceptionalFuture(Throwable t)

Creates a future that is synchronously completed exceptionally.

Parameters:

t - The future exception.

Returns:

The exceptionally completed future.

exceptionalFutureAsync

public static <T> CompletableFuture<T> exceptionalFutureAsync(Throwable t,
                                                              Executor executor)

Creates a future that is asynchronously completed exceptionally.

Parameters:

t - The future exception.

executor - The executor on which to complete the future.

Returns:

The exceptionally completed future.

orderedFuture

public static <T> CompletableFuture<T> orderedFuture()

Returns a future that completes callbacks in add order.

Type Parameters:

T - future value type

Returns:

a new completable future that will complete added callbacks in the order in which they were added

asyncFuture

public static <T> CompletableFuture<T> asyncFuture(CompletableFuture<T> future,
                                                   Executor executor)

Returns a wrapped future that will be completed on the given executor.

Type Parameters:

T - the future value type

Parameters:

future - the future to be completed on the given executor

executor - the executor with which to complete the future

Returns:

a wrapped future to be completed on the given executor