public final class CompletableFutureUtils extends Object
CompletionStage and CompletableFuture.| Modifier and Type | Method and Description |
|---|---|
static <T> CompletableFuture<T> |
exceptionallyCompletedFuture(Throwable e)
Creates a
CompletableFuture which is completed exceptionally with the given Exception. |
static <T> CompletableFuture<T> |
failed(Throwable e)
Creates a
CompletableFuture which is completed exceptionally with the given Exception. |
static <T,U> CompletionStage<U> |
flatMap(CompletionStage<T> future,
Function<? super T,CompletionStage<U>> f)
Applies a function to the successful result of a future.
|
static <T> CompletableFuture<List<T>> |
listOfFuturesToFutureOfList(List<? extends CompletionStage<T>> list)
Transforms a list of
CompletionStage into a CompletionStage of a list,
that will be completed once all the elements of the given list are completed. |
static <T,U> CompletionStage<U> |
map(CompletionStage<T> future,
Function<? super T,? extends U> f)
Applies a function to the successful result of a future.
|
static <T> CompletionStage<T> |
onFailure(CompletionStage<T> future,
Consumer<? super Throwable> consumer)
Executes a side-effect when the future completes exceptionally.
|
static <T> CompletionStage<T> |
onSuccess(CompletionStage<T> future,
Consumer<? super T> consumer)
Executes a side-effect when the future completes successfully.
|
static <T> T |
orElseGet(CompletionStage<T> stage,
Supplier<T> other)
Tries to access the completed future if available and returns its value (or exception in case the future completed exceptionally), otherwise uses the supplier to get a default value.
|
static <T,X extends Throwable> |
orElseThrow(CompletionStage<T> stage,
Supplier<? extends X> exceptionSupplier)
Tries to access the completed future if available and returns its value (or exception in case the future completed exceptionally), otherwise throws the given exception.
|
static <T> CompletionStage<T> |
recover(CompletionStage<T> future,
Function<Throwable,? extends T> f)
Creates a
CompletionStage which can be recovered if an error occurs. |
static <T> CompletableFuture<T> |
recoverWith(CompletionStage<T> future,
Function<? super Throwable,CompletionStage<T>> f)
Creates a
CompletionStage which can be recovered if an error occurs. |
static <T> CompletableFuture<T> |
recoverWith(CompletionStage<T> future,
Function<? super Throwable,CompletionStage<T>> f,
Executor executor)
Creates a
CompletionStage which can be recovered if an error occurs by executing a function in a certain thread pool. |
static <T> CompletableFuture<List<T>> |
sequence(List<? extends CompletionStage<T>> list)
Transforms a list of
CompletionStage into a CompletionStage of a list,
that will be completed once all the elements of the given list are completed. |
static <T> CompletableFuture<T> |
successful(T object)
Creates a
CompletableFuture which is completed successfully with the given object. |
static <T> void |
transferResult(CompletionStage<T> source,
CompletableFuture<T> target)
Internal JVM SDK util.
|
public static <T> CompletableFuture<T> successful(T object)
Creates a CompletableFuture which is completed successfully with the given object.
T - the type of the objectobject - the result of the futurepublic static <T> CompletableFuture<T> exceptionallyCompletedFuture(Throwable e)
Creates a CompletableFuture which is completed exceptionally with the given Exception.
Alias of failed(Throwable).
T - the type of the value of the success casee - exception for the futurepublic static <T> CompletableFuture<T> failed(Throwable e)
Creates a CompletableFuture which is completed exceptionally with the given Exception.
T - the type of the value of the success casee - exception for the futurepublic static <T> void transferResult(CompletionStage<T> source, CompletableFuture<T> target)
T - type of the value of the futuresource - the stage which may be completed at some timetarget - future which will receive the results of sourcepublic static <T> CompletionStage<T> onFailure(CompletionStage<T> future, Consumer<? super Throwable> consumer)
Executes a side-effect when the future completes exceptionally.
T - type of the futures valuefuture - the observed futureconsumer - code which should be executed if the future completes exceptionallypublic static <T> CompletionStage<T> onSuccess(CompletionStage<T> future, Consumer<? super T> consumer)
Executes a side-effect when the future completes successfully.
T - type of the futures valuefuture - the observed futureconsumer - code which should be executed if the future completes successfullypublic static <T> CompletionStage<T> recover(CompletionStage<T> future, Function<Throwable,? extends T> f)
Creates a CompletionStage which can be recovered if an error occurs. Alias for CompletionStage.exceptionally(Function).
If the recovery function also requires to create a CompletionStage then use recoverWith(CompletionStage, Function).
T - type of the value of the futurefuture - future which may completes exceptionallyf - function how the exception should be handled to create a successfully completed future, but it also can throw exceptionspublic static <T> CompletableFuture<T> recoverWith(CompletionStage<T> future, Function<? super Throwable,CompletionStage<T>> f)
Creates a CompletionStage which can be recovered if an error occurs.
If the recovery function does not require to create a CompletionStage then use recover(CompletionStage, Function).
T - type of the value of the futurefuture - future which may completes exceptionallyf - function how the exception should be handled to create a successfully completed futurepublic static <T> CompletableFuture<T> recoverWith(CompletionStage<T> future, Function<? super Throwable,CompletionStage<T>> f, Executor executor)
Creates a CompletionStage which can be recovered if an error occurs by executing a function in a certain thread pool.
If the recovery does not require to create a CompletionStage then use recover(CompletionStage, Function).
Have a look at recoverWith(CompletionStage, Function) for an example without the thread pool.
T - type of the value of the futurefuture - future which may completes exceptionallyf - function how the exception should be handled to create a successfully completed futureexecutor - thread pool to execute the recover functionpublic static <T,X extends Throwable> T orElseThrow(CompletionStage<T> stage, Supplier<? extends X> exceptionSupplier) throws X extends Throwable
Tries to access the completed future if available and returns its value (or exception in case the future completed exceptionally), otherwise throws the given exception.
T - the type of the future valueX - the type of the exception to be thrown if the value is absentstage - the futureexceptionSupplier - code which should be executed if the future is not yet completed (either successfully or exceptionally)X - exception in case the value is not availableX extends Throwablepublic static <T> T orElseGet(CompletionStage<T> stage, Supplier<T> other)
Tries to access the completed future if available and returns its value (or exception in case the future completed exceptionally), otherwise uses the supplier to get a default value.
T - the type of the future valuestage - the futureother - code which should be executed when the value is not available yet or the future completed exceptionallypublic static <T,U> CompletionStage<U> map(CompletionStage<T> future, Function<? super T,? extends U> f)
Applies a function to the successful result of a future.
If the function needs to return a CompletionStage use flatMap(CompletionStage, Function) instead.
T - type of value of the futureU - type of the value of the returned future which is also the return type of ffuture - the future to mapf - function which should be applied if the future completes successfullyf to the value of the original future.public static <T,U> CompletionStage<U> flatMap(CompletionStage<T> future, Function<? super T,CompletionStage<U>> f)
Applies a function to the successful result of a future.
If the function does not to return a CompletionStage use map(CompletionStage, Function) instead.
T - type of value of the futureU - type of the value of the returned future which is also the return type of ffuture - the future to mapf - function which should be applied if the future completes successfullyf to the value of the original future.public static <T> CompletableFuture<List<T>> listOfFuturesToFutureOfList(List<? extends CompletionStage<T>> list)
Transforms a list of CompletionStage into a CompletionStage of a list,
that will be completed once all the elements of the given list are completed.
In case multiple stages end exceptionally only one error is kept.
Alias of sequence(List).
T - the element obtained from the list of CompletionStagelist - list of CompletionStageCompletableFuture of a list of elementspublic static <T> CompletableFuture<List<T>> sequence(List<? extends CompletionStage<T>> list)
Transforms a list of CompletionStage into a CompletionStage of a list,
that will be completed once all the elements of the given list are completed.
In case multiple stages end exceptionally only one error is kept.
Alias of listOfFuturesToFutureOfList(List).
T - the element obtained from the list of CompletionStagelist - list of CompletionStageCompletableFuture of a list of elements