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<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.

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.