public final class CompletableFutureUtilsextends Object
Method Summary
Convenience method for creating a future that is immediately completed exceptionally with the given
Throwable.Forward the
Completes theThrowablefromsrctodst.dstfuture based on the result of thesrcfuture asynchronously on the providedExecutorand return thesrcfuture. Completes thedstfuture based on the result of thesrcfuture asynchronously on the providedExecutorand return thesrcfuture.Forward the
Completes theThrowablethat can be transformed as per the transformationFunction fromsrctodst.dstfuture based on the result of thesrcfuture, synchronously, after applying the provided transformationFunctionif successful.static <T> Tstatic voidstatic <T> TJoins (interruptibly) on the future, and re-throws any RuntimeExceptions or Errors just like the async task would have thrown if it was executed synchronously.
Method Details
failedFuture
Convenience method for creating a future that is immediately completed exceptionally with the givenThrowable.Similar to
CompletableFuture#failedFuturewhich was added in Java 9.- Type Parameters:
U- The type of the element.- Parameters:
t- The failure.- Returns:
- The failed future.
errorAsCompletionException
- Parameters:
t- The error.- Returns:
- The error as a CompletionException.
forwardExceptionTo
Forward the
Throwablefromsrctodst.- Parameters:
src- The source of theThrowable.dst- The destination where theThrowablewill be forwarded to.- Returns:
src.
forwardTransformedExceptionTo
Forward the
Throwablethat can be transformed as per the transformationFunction fromsrctodst.- Parameters:
src- The source of theThrowable.dst- The destination where theThrowablewill be forwarded totransformationFunction- Transformation function taht will be applied on to the forwarded exception.- Returns:
forwardResultTo
Completes thedstfuture based on the result of thesrcfuture asynchronously on the providedExecutorand return thesrcfuture.- Parameters:
src- The sourceCompletableFuturedst- The destination where theThrowableor response will be forwarded to.- Returns:
- the
srcfuture.
forwardResultTo
Completes thedstfuture based on the result of thesrcfuture asynchronously on the providedExecutorand return thesrcfuture.- Parameters:
src- The sourceCompletableFuturedst- The destination where theThrowableor response will be forwarded to.executor- the executor to complete the des future- Returns:
- the
srcfuture.
forwardTransformedResultTo
Completes thedstfuture based on the result of thesrcfuture, synchronously, after applying the provided transformationFunctionif successful.- Parameters:
src- The sourceCompletableFuturedst- The destination where theThrowableor transformed result will be forwarded to.- Returns:
- the
srcfuture.
allOfExceptionForwarded
- Parameters:
futures- The futures.- Returns:
- The new future that is completed when all the futures in
futuresare.
joinInterruptibly
joinInterruptiblyIgnoringFailures
joinLikeSync
Joins (interruptibly) on the future, and re-throws any RuntimeExceptions or Errors just like the async task would have thrown if it was executed synchronously.