io.airlift.concurrent

Class MoreFutures

java.lang.Object

io.airlift.concurrent.MoreFutures

public final class MoreFutures
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MoreFutures.ValueSupplier<T>

Method Summary

Modifier and Type	Method and Description
static <T> CompletableFuture<T>	addTimeout(CompletableFuture<T> future, MoreFutures.ValueSupplier<T> onTimeout, Duration timeout, ScheduledExecutorService executorService) Returns a new future that is completed when the supplied future completes or when the timeout expires.
static <V> CompletableFuture<List<V>>	allAsList(List<CompletableFuture<? extends V>> futures) Returns an unmodifiable future that is completed when all of the given futures complete.
static <V> CompletableFuture<V>	failedFuture(Throwable throwable) Returns a failed future containing the specified throwable.
static <V> CompletableFuture<V>	firstCompletedFuture(Iterable<? extends CompletionStage<? extends V>> futures) Creates a future that completes when the first future completes either normally or exceptionally.
static <V> CompletableFuture<V>	firstCompletedFuture(Iterable<? extends CompletionStage<? extends V>> futures, boolean propagateCancel) Creates a future that completes when the first future completes either normally or exceptionally.
static <V> V	getFutureValue(Future<V> future) Waits for the value from the future.
static <V,E extends Exception> V	getFutureValue(Future<V> future, Class<E> exceptionType) Waits for the value from the future.
static <V> CompletableFuture<V>	toCompletableFuture(com.google.common.util.concurrent.ListenableFuture<V> listenableFuture) Converts a ListenableFuture to a CompletableFuture.
static <V> com.google.common.util.concurrent.ListenableFuture<V>	toListenableFuture(CompletableFuture<V> completableFuture) Converts a CompletableFuture to a ListenableFuture.
static <T> Optional<T>	tryGetFutureValue(Future<T> future) Gets the current value of the future without waiting.
static <V> Optional<V>	tryGetFutureValue(Future<V> future, int timeout, TimeUnit timeUnit) Waits for the the value from the future for the specified time.
static <V,E extends Exception> Optional<V>	tryGetFutureValue(Future<V> future, int timeout, TimeUnit timeUnit, Class<E> exceptionType) Waits for the the value from the future for the specified time.
static <V> CompletableFuture<V>	unmodifiableFuture(CompletableFuture<V> future) Returns a future that can not be completed or canceled.
static <V> CompletableFuture<V>	unmodifiableFuture(CompletableFuture<V> future, boolean propagateCancel) Returns a future that can not be completed or optionally canceled.

Methods inherited from class java.lang.Object

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

Method Detail

unmodifiableFuture

public static <V> CompletableFuture<V> unmodifiableFuture(CompletableFuture<V> future)

Returns a future that can not be completed or canceled.

unmodifiableFuture

public static <V> CompletableFuture<V> unmodifiableFuture(CompletableFuture<V> future,
                                                          boolean propagateCancel)

Returns a future that can not be completed or optionally canceled.

failedFuture

public static <V> CompletableFuture<V> failedFuture(Throwable throwable)

Returns a failed future containing the specified throwable.

getFutureValue

public static <V> V getFutureValue(Future<V> future)

Waits for the value from the future. If the future is failed, the exception is thrown directly if unchecked or wrapped in a RuntimeException. If the thread is interrupted, the thread interruption flag is set and the original InterruptedException is wrapped in a RuntimeException and thrown.

getFutureValue

public static <V,E extends Exception> V getFutureValue(Future<V> future,
                                                       Class<E> exceptionType)
                                                throws E extends Exception

Waits for the value from the future. If the future is failed, the exception is thrown directly if it is an instance of the specified exception type or unchecked, or it is wrapped in a RuntimeException. If the thread is interrupted, the thread interruption flag is set and the original InterruptedException is wrapped in a RuntimeException and thrown.

Throws:

E extends Exception

tryGetFutureValue

public static <T> Optional<T> tryGetFutureValue(Future<T> future)

Gets the current value of the future without waiting. If the future value is null, an empty Optional is still returned, and in this case the caller must check the future directly for the null value.

tryGetFutureValue

public static <V> Optional<V> tryGetFutureValue(Future<V> future,
                                                int timeout,
                                                TimeUnit timeUnit)

Waits for the the value from the future for the specified time. If the future value is null, an empty Optional is still returned, and in this case the caller must check the future directly for the null value. If the future is failed, the exception is thrown directly if unchecked or wrapped in a RuntimeException. If the thread is interrupted, the thread interruption flag is set and the original InterruptedException is wrapped in a RuntimeException and thrown.

tryGetFutureValue

public static <V,E extends Exception> Optional<V> tryGetFutureValue(Future<V> future,
                                                                    int timeout,
                                                                    TimeUnit timeUnit,
                                                                    Class<E> exceptionType)
                                                             throws E extends Exception

Waits for the the value from the future for the specified time. If the future value is null, an empty Optional is still returned, and in this case the caller must check the future directly for the null value. If the future is failed, the exception is thrown directly if it is an instance of the specified exception type or unchecked, or it is wrapped in a RuntimeException. If the thread is interrupted, the thread interruption flag is set and the original InterruptedException is wrapped in a RuntimeException and thrown.

Throws:

E extends Exception

firstCompletedFuture

public static <V> CompletableFuture<V> firstCompletedFuture(Iterable<? extends CompletionStage<? extends V>> futures)

Creates a future that completes when the first future completes either normally or exceptionally. Cancellation of the future does not propagate to the supplied futures.

firstCompletedFuture

public static <V> CompletableFuture<V> firstCompletedFuture(Iterable<? extends CompletionStage<? extends V>> futures,
                                                            boolean propagateCancel)

Creates a future that completes when the first future completes either normally or exceptionally. Cancellation of the future will optionally propagate to the supplied futures.

allAsList

public static <V> CompletableFuture<List<V>> allAsList(List<CompletableFuture<? extends V>> futures)

Returns an unmodifiable future that is completed when all of the given futures complete. If any of the given futures complete exceptionally, then the returned future also does so immediately, with a CompletionException holding this exception as its cause. Otherwise, the results of the given futures are reflected in the returned future as a list of results matching the input order. If no futures are provided, returns a future completed with an empty list.

addTimeout

public static <T> CompletableFuture<T> addTimeout(CompletableFuture<T> future,
                                                  MoreFutures.ValueSupplier<T> onTimeout,
                                                  Duration timeout,
                                                  ScheduledExecutorService executorService)

Returns a new future that is completed when the supplied future completes or when the timeout expires. If the timeout occurs or the returned CompletableFuture is canceled, the supplied future will be canceled.

toCompletableFuture

public static <V> CompletableFuture<V> toCompletableFuture(com.google.common.util.concurrent.ListenableFuture<V> listenableFuture)

Converts a ListenableFuture to a CompletableFuture. Cancellation of the CompletableFuture will be propagated to the ListenableFuture.

toListenableFuture

public static <V> com.google.common.util.concurrent.ListenableFuture<V> toListenableFuture(CompletableFuture<V> completableFuture)

Converts a CompletableFuture to a ListenableFuture. Cancellation of the ListenableFuture will be propagated to the CompletableFuture.