# CompletableFuture Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Nested Classes](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#nestedclasses)\|[Ctors](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#pubctors)\|[Methods](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#inhmethods) # CompletableFuture ` public class CompletableFuture ` ` extends `[Object](https://developer.android.com/reference/java/lang/Object)` `` implements `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`, `[Future](https://developer.android.com/reference/java/util/concurrent/Future)` ` |---|---------------------------------------------| | [java.lang.Object](https://developer.android.com/reference/java/lang/Object) || | ↳ | java.util.concurrent.CompletableFuture\ |
*** ** * ** *** A[Future](https://developer.android.com/reference/java/util/concurrent/Future)that may be explicitly completed (setting its value and status), and may be used as a[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage), supporting dependent functions and actions that trigger upon its completion. When two or more threads attempt to[complete](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#complete(T)),[completeExceptionally](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completeExceptionally(java.lang.Throwable)), or[cancel](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#cancel(boolean))a CompletableFuture, only one of them succeeds. In addition to these and related methods for directly manipulating status and results, CompletableFuture implements interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)with the following policies: - Actions supplied for dependent completions of*non-async*methods may be performed by the thread that completes the current CompletableFuture, or by any other caller of a completion method. - All*async* methods without an explicit Executor argument are performed using the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())(unless it does not support a parallelism level of at least two, in which case, a new Thread is created to run each task). To simplify monitoring, debugging, and tracking, all generated asynchronous tasks are instances of the marker interface[AsynchronousCompletionTask](https://developer.android.com/reference/java/util/concurrent/CompletableFuture.AsynchronousCompletionTask). Operations with time-delays can use adapter methods defined in this class, for example:`supplyAsync(supplier, delayedExecutor(timeout, timeUnit))`. To support methods with delays and timeouts, this class maintains at most one daemon thread for triggering and cancelling actions, not for running them. - All CompletionStage methods are implemented independently of other public methods, so the behavior of one method is not impacted by overrides of others in subclasses. CompletableFuture also implements[Future](https://developer.android.com/reference/java/util/concurrent/Future)with the following policies: - Since (unlike[FutureTask](https://developer.android.com/reference/java/util/concurrent/FutureTask)) this class has no direct control over the computation that causes it to be completed, cancellation is treated as just another form of exceptional completion. Method[cancel](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#cancel(boolean))has the same effect as`completeExceptionally(new CancellationException())`. Method[isCompletedExceptionally()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#isCompletedExceptionally())can be used to determine if a CompletableFuture completed in any exceptional fashion. - In case of exceptional completion with a CompletionException, methods[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and[get(long, java.util.concurrent.TimeUnit)](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get(long,%20java.util.concurrent.TimeUnit))throw an[ExecutionException](https://developer.android.com/reference/java/util/concurrent/ExecutionException)with the same cause as held in the corresponding CompletionException. To simplify usage in most contexts, this class also defines methods[join()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#join())and[getNow(T)](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#getNow(T))that instead throw the CompletionException directly in these cases. Arguments used to pass a completion result (that is, for parameters of type`T`) for methods accepting them may be null, but passing a null value for any other parameter will result in a[NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException)being thrown. ## Summary | ### Nested classes || |--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` interface` | [CompletableFuture.AsynchronousCompletionTask](https://developer.android.com/reference/java/util/concurrent/CompletableFuture.AsynchronousCompletionTask) A marker interface identifying asynchronous tasks produced by`async`methods. | | ### Public constructors || |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---| | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#CompletableFuture())`() ` Creates a new incomplete CompletableFuture. | | ### Public methods || |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEither](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#acceptEither(java.util.concurrent.CompletionStage,%20java.util.function.Consumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#acceptEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Consumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#acceptEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Consumer,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied action. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[allOf](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#allOf(java.util.concurrent.CompletableFuture[]))`(`[CompletableFuture...](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)` cfs) ` Returns a new CompletableFuture that is completed when all of the given CompletableFutures complete. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Object](https://developer.android.com/reference/java/lang/Object)`>` | ` `[anyOf](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#anyOf(java.util.concurrent.CompletableFuture[]))`(`[CompletableFuture...](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)` cfs) ` Returns a new CompletableFuture that is completed when any of the given CompletableFutures complete, with the same result. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[applyToEither](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#applyToEither(java.util.concurrent.CompletionStage,%20java.util.function.Function))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[applyToEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#applyToEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Function,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[applyToEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#applyToEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Function))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied function. | | ` boolean` | ` `[cancel](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#cancel(boolean))`(boolean mayInterruptIfRunning) ` If not already completed, completes this CompletableFuture with a[CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException). | | ` boolean` | ` `[complete](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#complete(T))`(T value) ` If not already completed, sets the value returned by[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to the given value. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[completeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completeAsync(java.util.function.Supplier,%20java.util.concurrent.Executor))`(`[Supplier](https://developer.android.com/reference/java/util/function/Supplier)` supplier, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Completes this CompletableFuture with the result of the given Supplier function invoked from an asynchronous task using the given executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[completeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completeAsync(java.util.function.Supplier))`(`[Supplier](https://developer.android.com/reference/java/util/function/Supplier)` supplier) ` Completes this CompletableFuture with the result of the given Supplier function invoked from an asynchronous task using the default executor. | | ` boolean` | ` `[completeExceptionally](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completeExceptionally(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` ex) ` If not already completed, causes invocations of[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to throw the given exception. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[completeOnTimeout](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completeOnTimeout(T,%20long,%20java.util.concurrent.TimeUnit))`(T value, long timeout, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit) ` Completes this CompletableFuture with the given value if not otherwise completed before the given timeout. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[completedFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completedFuture(U))`(U value) ` Returns a new CompletableFuture that is already completed with the given value. | | ` static `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[completedStage](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#completedStage(U))`(U value) ` Returns a new CompletionStage that is already completed with the given value and supports only those methods in interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage). | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[copy](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#copy())`() ` Returns a new CompletableFuture that is completed normally with the same value as this CompletableFuture when it completes normally. | | ` `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | ` `[defaultExecutor](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#defaultExecutor())`() ` Returns the default Executor used for async methods that do not specify an Executor. | | ` static `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | ` `[delayedExecutor](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#delayedExecutor(long,%20java.util.concurrent.TimeUnit,%20java.util.concurrent.Executor))`(long delay, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new Executor that submits a task to the given base executor after the given delay (or no delay if non-positive). | | ` static `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | ` `[delayedExecutor](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#delayedExecutor(long,%20java.util.concurrent.TimeUnit))`(long delay, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit) ` Returns a new Executor that submits a task to the default executor after the given delay (or no delay if non-positive). | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[exceptionNow](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionNow())`() ` Returns the exception thrown by the task, without waiting. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionally](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionally(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionallyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionallyAsync(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using this stage's default asynchronous execution facility. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionallyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionallyAsync(java.util.function.Function,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using the supplied Executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionallyCompose](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionallyCompose(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionallyComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionallyComposeAsync(java.util.function.Function>,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using the supplied Executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[exceptionallyComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#exceptionallyComposeAsync(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using this stage's default asynchronous execution facility. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[failedFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#failedFuture(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` ex) ` Returns a new CompletableFuture that is already completed exceptionally with the given exception. | | ` static `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[failedStage](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#failedStage(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` ex) ` Returns a new CompletionStage that is already completed exceptionally with the given exception and supports only those methods in interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage). | | ` T` | ` `[get](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get(long,%20java.util.concurrent.TimeUnit))`(long timeout, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit) ` Waits if necessary for at most the given time for this future to complete, and then returns its result, if available. | | ` T` | ` `[get](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())`() ` Waits if necessary for this future to complete, and then returns its result. | | ` T` | ` `[getNow](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#getNow(T))`(T valueIfAbsent) ` Returns the result value (or throws any encountered exception) if completed, else returns the given valueIfAbsent. | | ` int` | ` `[getNumberOfDependents](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#getNumberOfDependents())`() ` Returns the estimated number of CompletableFutures whose completions are awaiting completion of this CompletableFuture. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[handle](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#handle(java.util.function.BiFunction))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed with this stage's result and exception as arguments to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#handleAsync(java.util.function.BiFunction))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using this stage's default asynchronous execution facility, with this stage's result and exception as arguments to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#handleAsync(java.util.function.BiFunction,%20java.util.concurrent.Executor))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using the supplied executor, with this stage's result and exception as arguments to the supplied function. | | ` boolean` | ` `[isCancelled](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#isCancelled())`() ` Returns`true`if this CompletableFuture was cancelled before it completed normally. | | ` boolean` | ` `[isCompletedExceptionally](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#isCompletedExceptionally())`() ` Returns`true`if this CompletableFuture completed exceptionally, in any way. | | ` boolean` | ` `[isDone](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#isDone())`() ` Returns`true`if completed in any fashion: normally, exceptionally, or via cancellation. | | ` T` | ` `[join](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#join())`() ` Returns the result value when complete, or throws an (unchecked) exception if completed exceptionally. | | ` `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[minimalCompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#minimalCompletionStage())`() ` Returns a new CompletionStage that is completed normally with the same value as this CompletableFuture when it completes normally, and cannot be independently completed or otherwise used in ways not defined by the methods of interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage). | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[newIncompleteFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#newIncompleteFuture())`() ` Returns a new incomplete CompletableFuture of the type to be returned by a CompletionStage method. | | ` void` | ` `[obtrudeException](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#obtrudeException(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` ex) ` Forcibly causes subsequent invocations of method[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to throw the given exception, whether or not already completed. | | ` void` | ` `[obtrudeValue](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#obtrudeValue(T))`(T value) ` Forcibly sets or resets the value subsequently returned by method[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods, whether or not already completed. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[orTimeout](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#orTimeout(long,%20java.util.concurrent.TimeUnit))`(long timeout, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit) ` Exceptionally completes this CompletableFuture with a[TimeoutException](https://developer.android.com/reference/java/util/concurrent/TimeoutException)if not otherwise completed before the given timeout. | | ` T` | ` `[resultNow](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#resultNow())`() ` Returns the computed result, without waiting. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBoth](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterBoth(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterBothAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using this stage's default asynchronous execution facility. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterBothAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using the supplied executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEither](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterEither(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterEitherAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using the supplied executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAfterEitherAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using this stage's default asynchronous execution facility. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAsync(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` runnable) ` Returns a new CompletableFuture that is asynchronously completed by a task running in the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())after it runs the given action. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#runAsync(java.lang.Runnable,%20java.util.concurrent.Executor))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` runnable, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletableFuture that is asynchronously completed by a task running in the given executor after it runs the given action. | | ` `[Future.State](https://developer.android.com/reference/java/util/concurrent/Future.State) | ` `[state](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#state())`() `
| | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[supplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#supplyAsync(java.util.function.Supplier))`(`[Supplier](https://developer.android.com/reference/java/util/function/Supplier)` supplier) ` Returns a new CompletableFuture that is asynchronously completed by a task running in the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())with the value obtained by calling the given Supplier. | | ` static `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[supplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#supplyAsync(java.util.function.Supplier,%20java.util.concurrent.Executor))`(`[Supplier](https://developer.android.com/reference/java/util/function/Supplier)` supplier, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletableFuture that is asynchronously completed by a task running in the given executor with the value obtained by calling the given Supplier. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAccept](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAccept(java.util.function.Consumer))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAcceptAsync(java.util.function.Consumer,%20java.util.concurrent.Executor))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAcceptAsync(java.util.function.Consumer))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBoth](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAcceptBoth(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAcceptBothAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenAcceptBothAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenApply](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenApply(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenApplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenApplyAsync(java.util.function.Function,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenApplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenApplyAsync(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenCombine](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenCombine(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenCombineAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenCombineAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenCombineAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenCombineAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenCompose](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenCompose(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenComposeAsync(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using this stage's default asynchronous execution facility. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[thenComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenComposeAsync(java.util.function.Function>,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using the supplied Executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRun](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenRun(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRunAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenRunAsync(java.lang.Runnable,%20java.util.concurrent.Executor))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action using the supplied Executor. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRunAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#thenRunAsync(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action using this stage's default asynchronous execution facility. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[toCompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#toCompletableFuture())`() ` Returns this CompletableFuture. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#toString())`() ` Returns a string identifying this CompletableFuture, as well as its completion state. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[whenComplete](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#whenComplete(java.util.function.BiConsumer))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action when this stage completes. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[whenCompleteAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#whenCompleteAsync(java.util.function.BiConsumer,%20java.util.concurrent.Executor))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using the supplied Executor when this stage completes. | | ` `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[whenCompleteAsync](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#whenCompleteAsync(java.util.function.BiConsumer))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using this stage's default asynchronous execution facility when this stage completes. | | ### Inherited methods | |-----------------------|---| | From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | || | From interface` `[java.util.concurrent.CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` ` |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEither](https://developer.android.com/reference/java/util/concurrent/CompletionStage#acceptEither(java.util.concurrent.CompletionStage,%20java.util.function.Consumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#acceptEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Consumer,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[acceptEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#acceptEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Consumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[applyToEither](https://developer.android.com/reference/java/util/concurrent/CompletionStage#applyToEither(java.util.concurrent.CompletionStage,%20java.util.function.Function))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[applyToEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#applyToEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Function,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[applyToEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#applyToEitherAsync(java.util.concurrent.CompletionStage,%20java.util.function.Function))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionally](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionally(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function. | | ` default `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionallyAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionallyAsync(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using this stage's default asynchronous execution facility. | | ` default `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionallyAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionallyAsync(java.util.function.Function,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends T> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using the supplied Executor. | | ` default `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionallyCompose](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionallyCompose(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception. | | ` default `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionallyComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionallyComposeAsync(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using this stage's default asynchronous execution facility. | | ` default `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[exceptionallyComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#exceptionallyComposeAsync(java.util.function.Function>,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`<`[Throwable](https://developer.android.com/reference/java/lang/Throwable)`, ? extends `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using the supplied Executor. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[handle](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handle(java.util.function.BiFunction))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed with this stage's result and exception as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handleAsync(java.util.function.BiFunction))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using this stage's default asynchronous execution facility, with this stage's result and exception as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handleAsync(java.util.function.BiFunction,%20java.util.concurrent.Executor))`(`[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using the supplied executor, with this stage's result and exception as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBoth](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterBoth(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterBothAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using this stage's default asynchronous execution facility. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterBothAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using the supplied executor. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEither](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterEither(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterEitherAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using this stage's default asynchronous execution facility. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[runAfterEitherAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#runAfterEitherAsync(java.util.concurrent.CompletionStage,%20java.lang.Runnable,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using the supplied executor. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAccept](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAccept(java.util.function.Consumer))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAcceptAsync(java.util.function.Consumer,%20java.util.concurrent.Executor))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAcceptAsync(java.util.function.Consumer))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)` action) ` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBoth](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAcceptBoth(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAcceptBothAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenAcceptBothAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenAcceptBothAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiConsumer,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenApply](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenApply(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenApplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenApplyAsync(java.util.function.Function,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenApplyAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenApplyAsync(java.util.function.Function))`(`[Function](https://developer.android.com/reference/java/util/function/Function)` fn) ` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenCombine](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenCombine(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenCombineAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenCombineAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenCombineAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenCombineAsync(java.util.concurrent.CompletionStage,%20java.util.function.BiFunction,%20java.util.concurrent.Executor))`(`[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)` other, `[BiFunction](https://developer.android.com/reference/java/util/function/BiFunction)` fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenCompose](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenCompose(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenComposeAsync(java.util.function.Function>,%20java.util.concurrent.Executor))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using the supplied Executor. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[thenComposeAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenComposeAsync(java.util.function.Function>))`(`[Function](https://developer.android.com/reference/java/util/function/Function)`> fn) ` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using this stage's default asynchronous execution facility. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRun](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenRun(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRunAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenRunAsync(java.lang.Runnable,%20java.util.concurrent.Executor))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action using the supplied Executor. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | ` `[thenRunAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#thenRunAsync(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` action) ` Returns a new CompletionStage that, when this stage completes normally, executes the given action using this stage's default asynchronous execution facility. | | ` abstract `[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | ` `[toCompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletionStage#toCompletableFuture())`() ` Returns a[CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)maintaining the same completion properties as this stage. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[whenComplete](https://developer.android.com/reference/java/util/concurrent/CompletionStage#whenComplete(java.util.function.BiConsumer))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action when this stage completes. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[whenCompleteAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#whenCompleteAsync(java.util.function.BiConsumer,%20java.util.concurrent.Executor))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action, `[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using the supplied Executor when this stage completes. | | ` abstract `[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | ` `[whenCompleteAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#whenCompleteAsync(java.util.function.BiConsumer))`(`[BiConsumer](https://developer.android.com/reference/java/util/function/BiConsumer)` action) ` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using this stage's default asynchronous execution facility when this stage completes. | || | From interface` `[java.util.concurrent.Future](https://developer.android.com/reference/java/util/concurrent/Future)` ` |------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract boolean` | ` `[cancel](https://developer.android.com/reference/java/util/concurrent/Future#cancel(boolean))`(boolean mayInterruptIfRunning) ` Attempts to cancel execution of this task. | | ` default `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[exceptionNow](https://developer.android.com/reference/java/util/concurrent/Future#exceptionNow())`() ` Returns the exception thrown by the task, without waiting. | | ` abstract T` | ` `[get](https://developer.android.com/reference/java/util/concurrent/Future#get(long,%20java.util.concurrent.TimeUnit))`(long timeout, `[TimeUnit](https://developer.android.com/reference/java/util/concurrent/TimeUnit)` unit) ` Waits if necessary for at most the given time for the computation to complete, and then retrieves its result, if available. | | ` abstract T` | ` `[get](https://developer.android.com/reference/java/util/concurrent/Future#get())`() ` Waits if necessary for the computation to complete, and then retrieves its result. | | ` abstract boolean` | ` `[isCancelled](https://developer.android.com/reference/java/util/concurrent/Future#isCancelled())`() ` Returns`true`if this task was cancelled before it completed normally. | | ` abstract boolean` | ` `[isDone](https://developer.android.com/reference/java/util/concurrent/Future#isDone())`() ` Returns`true`if this task completed. | | ` default T` | ` `[resultNow](https://developer.android.com/reference/java/util/concurrent/Future#resultNow())`() ` Returns the computed result, without waiting. | | ` default `[Future.State](https://developer.android.com/reference/java/util/concurrent/Future.State) | ` `[state](https://developer.android.com/reference/java/util/concurrent/Future#state())`() `
| || ## Public constructors ### CompletableFuture Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture () ``` Creates a new incomplete CompletableFuture.
## Public methods ### acceptEither Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture acceptEither (CompletionStage other, Consumer action) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### acceptEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture acceptEitherAsync (CompletionStage other, Consumer action) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### acceptEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture acceptEitherAsync (CompletionStage other, Consumer action, Executor executor) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### allOf Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture allOf (CompletableFuture... cfs) ``` Returns a new CompletableFuture that is completed when all of the given CompletableFutures complete. If any of the given CompletableFutures complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause. Otherwise, the results, if any, of the given CompletableFutures are not reflected in the returned CompletableFuture, but may be obtained by inspecting them individually. If no CompletableFutures are provided, returns a CompletableFuture completed with the value`null`. Among the applications of this method is to await completion of a set of independent CompletableFutures before continuing a program, as in:`CompletableFuture.allOf(c1, c2, c3).join();`.
| Parameters || |-------|----------------------------------------------------| | `cfs` | `CompletableFuture`: the CompletableFutures
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | a new CompletableFuture that is completed when all of the given CompletableFutures complete
| | Throws || |------------------------------------------------------------------------------------------------|-----------------------------------------------| | [NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException) | if the array or any of its elements are`null` | ### anyOf Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture anyOf (CompletableFuture... cfs) ``` Returns a new CompletableFuture that is completed when any of the given CompletableFutures complete, with the same result. Otherwise, if it completed exceptionally, the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause. If no CompletableFutures are provided, returns an incomplete CompletableFuture.
| Parameters || |-------|----------------------------------------------------| | `cfs` | `CompletableFuture`: the CompletableFutures
| | Returns || |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Object](https://developer.android.com/reference/java/lang/Object)`>` | a new CompletableFuture that is completed with the result or exception of any of the given CompletableFutures when one completes
| | Throws || |------------------------------------------------------------------------------------------------|-----------------------------------------------| | [NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException) | if the array or any of its elements are`null` | ### applyToEither Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture applyToEither (CompletionStage other, Function fn) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed with the corresponding result as argument to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |---------|---------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### applyToEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture applyToEitherAsync (CompletionStage other, Function fn, Executor executor) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using the supplied executor, with the corresponding result as argument to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|---------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### applyToEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture applyToEitherAsync (CompletionStage other, Function fn) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, is executed using this stage's default asynchronous execution facility, with the corresponding result as argument to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |---------|---------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### cancel Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean cancel (boolean mayInterruptIfRunning) ``` If not already completed, completes this CompletableFuture with a[CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException). Dependent CompletableFutures that have not already completed will also complete exceptionally, with a[CompletionException](https://developer.android.com/reference/java/util/concurrent/CompletionException)caused by this`CancellationException`.
| Parameters || |-------------------------|--------------------------------------------------------------------------------------------------------------------------| | `mayInterruptIfRunning` | `boolean`: this value has no effect in this implementation because interrupts are not used to control processing.
| | Returns || |-----------|--------------------------------------------| | `boolean` | `true`if this task is now cancelled
| ### complete Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean complete (T value) ``` If not already completed, sets the value returned by[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to the given value.
| Parameters || |---------|------------------------------| | `value` | `T`: the result value
| | Returns || |-----------|---------------------------------------------------------------------------------------------------------------| | `boolean` | `true`if this invocation caused this CompletableFuture to transition to a completed state, else`false`
| ### completeAsync Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture completeAsync (Supplier supplier, Executor executor) ``` Completes this CompletableFuture with the result of the given Supplier function invoked from an asynchronous task using the given executor.
| Parameters || |------------|-------------------------------------------------------------------------------------------------| | `supplier` | `Supplier`: a function returning the value to be used to complete this CompletableFuture
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|-------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | this CompletableFuture
| ### completeAsync Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture completeAsync (Supplier supplier) ``` Completes this CompletableFuture with the result of the given Supplier function invoked from an asynchronous task using the default executor.
| Parameters || |------------|-------------------------------------------------------------------------------------------------| | `supplier` | `Supplier`: a function returning the value to be used to complete this CompletableFuture
| | Returns || |----------------------------------------------------------------------------------------------------------|-------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | this CompletableFuture
| ### completeExceptionally Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean completeExceptionally (Throwable ex) ``` If not already completed, causes invocations of[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to throw the given exception.
| Parameters || |------|-----------------------------------| | `ex` | `Throwable`: the exception
| | Returns || |-----------|---------------------------------------------------------------------------------------------------------------| | `boolean` | `true`if this invocation caused this CompletableFuture to transition to a completed state, else`false`
| ### completeOnTimeout Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture completeOnTimeout (T value, long timeout, TimeUnit unit) ``` Completes this CompletableFuture with the given value if not otherwise completed before the given timeout.
| Parameters || |-----------|----------------------------------------------------------------------------------------------------| | `value` | `T`: the value to use upon timeout
| | `timeout` | `long`: how long to wait before completing normally with the given value, in units of`unit`
| | `unit` | `TimeUnit`: a`TimeUnit`determining how to interpret the`timeout`parameter
| | Returns || |----------------------------------------------------------------------------------------------------------|-------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | this CompletableFuture
| ### completedFuture Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture completedFuture (U value) ``` Returns a new CompletableFuture that is already completed with the given value.
| Parameters || |---------|-----------------------| | `value` | `U`: the value
| | Returns || |----------------------------------------------------------------------------------------------------------|----------------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the completed CompletableFuture
| ### completedStage Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletionStage completedStage (U value) ``` Returns a new CompletionStage that is already completed with the given value and supports only those methods in interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage).
| Parameters || |---------|-----------------------| | `value` | `U`: the value
| | Returns || |------------------------------------------------------------------------------------------------------|--------------------------------------| | [CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | the completed CompletionStage
| ### copy Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture copy () ``` Returns a new CompletableFuture that is completed normally with the same value as this CompletableFuture when it completes normally. If this CompletableFuture completes exceptionally, then the returned CompletableFuture completes exceptionally with a CompletionException with this exception as cause. The behavior is equivalent to`thenApply(x -> x)`. This method may be useful as a form of "defensive copying", to prevent clients from completing, while still being able to arrange dependent actions.
| Returns || |----------------------------------------------------------------------------------------------------------|----------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletableFuture
| ### defaultExecutor Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public Executor defaultExecutor () ``` Returns the default Executor used for async methods that do not specify an Executor. This class uses the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())if it supports more than one parallel thread, or else an Executor using one thread per async task. This method may be overridden in subclasses to return an Executor that provides at least one independent thread.
| Returns || |-----------------------------------------------------------------------------------|---------------------| | [Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | the executor
| ### delayedExecutor Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static Executor delayedExecutor (long delay, TimeUnit unit, Executor executor) ``` Returns a new Executor that submits a task to the given base executor after the given delay (or no delay if non-positive). Each delay commences upon invocation of the returned executor's`execute`method.
| Parameters || |------------|--------------------------------------------------------------------------------| | `delay` | `long`: how long to delay, in units of`unit`
| | `unit` | `TimeUnit`: a`TimeUnit`determining how to interpret the`delay`parameter
| | `executor` | `Executor`: the base executor
| | Returns || |-----------------------------------------------------------------------------------|---------------------------------| | [Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | the new delayed executor
| ### delayedExecutor Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static Executor delayedExecutor (long delay, TimeUnit unit) ``` Returns a new Executor that submits a task to the default executor after the given delay (or no delay if non-positive). Each delay commences upon invocation of the returned executor's`execute`method.
| Parameters || |---------|--------------------------------------------------------------------------------| | `delay` | `long`: how long to delay, in units of`unit`
| | `unit` | `TimeUnit`: a`TimeUnit`determining how to interpret the`delay`parameter
| | Returns || |-----------------------------------------------------------------------------------|---------------------------------| | [Executor](https://developer.android.com/reference/java/util/concurrent/Executor) | the new delayed executor
| ### exceptionNow Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public Throwable exceptionNow () ``` Returns the exception thrown by the task, without waiting. This method is for cases where the caller knows that the task has already completed with an exception.
| Returns || |--------------------------------------------------------------------------|-----------------------------------------| | [Throwable](https://developer.android.com/reference/java/lang/Throwable) | the exception thrown by the task
| ### exceptionally Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionally (Function fn) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function. Otherwise, if this stage completes normally, then the returned stage also completes normally with the same value.
| Parameters || |------|---------------------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage if this CompletionStage completed exceptionally
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### exceptionallyAsync Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionallyAsync (Function fn) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using this stage's default asynchronous execution facility. Otherwise, if this stage completes normally, then the returned stage also completes normally with the same value.
| Parameters || |------|---------------------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage if this CompletionStage completed exceptionally
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### exceptionallyAsync Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionallyAsync (Function fn, Executor executor) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is executed with this stage's exception as the argument to the supplied function, using the supplied Executor. Otherwise, if this stage completes normally, then the returned stage also completes normally with the same value.
| Parameters || |------------|---------------------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage if this CompletionStage completed exceptionally
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### exceptionallyCompose Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionallyCompose (Function> fn) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception.
| Parameters || |------|--------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the returned CompletionStage if this CompletionStage completed exceptionally
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### exceptionallyComposeAsync Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionallyComposeAsync (Function> fn, Executor executor) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using the supplied Executor.
| Parameters || |------------|--------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the returned CompletionStage if this CompletionStage completed exceptionally
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### exceptionallyComposeAsync Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture exceptionallyComposeAsync (Function> fn) ``` Returns a new CompletionStage that, when this stage completes exceptionally, is composed using the results of the supplied function applied to this stage's exception, using this stage's default asynchronous execution facility.
| Parameters || |------|--------------------------------------------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the returned CompletionStage if this CompletionStage completed exceptionally
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### failedFuture Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture failedFuture (Throwable ex) ``` Returns a new CompletableFuture that is already completed exceptionally with the given exception.
| Parameters || |------|-----------------------------------| | `ex` | `Throwable`: the exception
| | Returns || |----------------------------------------------------------------------------------------------------------|------------------------------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the exceptionally completed CompletableFuture
| ### failedStage Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletionStage failedStage (Throwable ex) ``` Returns a new CompletionStage that is already completed exceptionally with the given exception and supports only those methods in interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage).
| Parameters || |------|-----------------------------------| | `ex` | `Throwable`: the exception
| | Returns || |------------------------------------------------------------------------------------------------------|----------------------------------------------------| | [CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | the exceptionally completed CompletionStage
| ### get Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public T get (long timeout, TimeUnit unit) ``` Waits if necessary for at most the given time for this future to complete, and then returns its result, if available.
| Parameters || |-----------|----------------------------------------------------------| | `timeout` | `long`: the maximum time to wait
| | `unit` | `TimeUnit`: the time unit of the timeout argument
| | Returns || |-----|-------------------------| | `T` | the result value
| | Throws || |-------------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException) | if this future was cancelled | | [ExecutionException](https://developer.android.com/reference/java/util/concurrent/ExecutionException) | if this future completed exceptionally | | [InterruptedException](https://developer.android.com/reference/java/lang/InterruptedException) | if the current thread was interrupted while waiting | | [TimeoutException](https://developer.android.com/reference/java/util/concurrent/TimeoutException) | if the wait timed out | ### get Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public T get () ``` Waits if necessary for this future to complete, and then returns its result.
| Returns || |-----|-------------------------| | `T` | the result value
| | Throws || |-------------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException) | if this future was cancelled | | [ExecutionException](https://developer.android.com/reference/java/util/concurrent/ExecutionException) | if this future completed exceptionally | | [InterruptedException](https://developer.android.com/reference/java/lang/InterruptedException) | if the current thread was interrupted while waiting | ### getNow Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public T getNow (T valueIfAbsent) ``` Returns the result value (or throws any encountered exception) if completed, else returns the given valueIfAbsent.
| Parameters || |-----------------|--------------------------------------------------| | `valueIfAbsent` | `T`: the value to return if not completed
| | Returns || |-----|---------------------------------------------------------------------| | `T` | the result value, if completed, else the given valueIfAbsent
| | Throws || |-------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------| | [CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException) | if the computation was cancelled | | [CompletionException](https://developer.android.com/reference/java/util/concurrent/CompletionException) | if this future completed exceptionally or a completion computation threw an exception | ### getNumberOfDependents Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public int getNumberOfDependents () ``` Returns the estimated number of CompletableFutures whose completions are awaiting completion of this CompletableFuture. This method is designed for use in monitoring system state, not for synchronization control.
| Returns || |-------|---------------------------------------------------| | `int` | the number of dependent CompletableFutures
| ### handle Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture handle (BiFunction fn) ``` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed with this stage's result and exception as arguments to the supplied function. When this stage is complete, the given function is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments, and the function's result is used to complete the returned stage.
| Parameters || |------|-----------------------------------------------------------------------------------------------| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### handleAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture handleAsync (BiFunction fn) ``` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using this stage's default asynchronous execution facility, with this stage's result and exception as arguments to the supplied function. When this stage is complete, the given function is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments, and the function's result is used to complete the returned stage.
| Parameters || |------|-----------------------------------------------------------------------------------------------| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### handleAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture handleAsync (BiFunction fn, Executor executor) ``` Returns a new CompletionStage that, when this stage completes either normally or exceptionally, is executed using the supplied executor, with this stage's result and exception as arguments to the supplied function. When this stage is complete, the given function is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments, and the function's result is used to complete the returned stage.
| Parameters || |------------|-----------------------------------------------------------------------------------------------| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### isCancelled Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean isCancelled () ``` Returns`true`if this CompletableFuture was cancelled before it completed normally.
| Returns || |-----------|-----------------------------------------------------------------------------------| | `boolean` | `true`if this CompletableFuture was cancelled before it completed normally
| ### isCompletedExceptionally Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean isCompletedExceptionally () ``` Returns`true`if this CompletableFuture completed exceptionally, in any way. Possible causes include cancellation, explicit invocation of`completeExceptionally`, and abrupt termination of a CompletionStage action.
| Returns || |-----------|----------------------------------------------------------------| | `boolean` | `true`if this CompletableFuture completed exceptionally
| ### isDone Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public boolean isDone () ``` Returns`true`if completed in any fashion: normally, exceptionally, or via cancellation.
| Returns || |-----------|---------------------------| | `boolean` | `true`if completed
| ### join Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public T join () ``` Returns the result value when complete, or throws an (unchecked) exception if completed exceptionally. To better conform with the use of common functional forms, if a computation involved in the completion of this CompletableFuture threw an exception, this method throws an (unchecked)[CompletionException](https://developer.android.com/reference/java/util/concurrent/CompletionException)with the underlying exception as its cause.
| Returns || |-----|-------------------------| | `T` | the result value
| | Throws || |-------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------| | [CancellationException](https://developer.android.com/reference/java/util/concurrent/CancellationException) | if the computation was cancelled | | [CompletionException](https://developer.android.com/reference/java/util/concurrent/CompletionException) | if this future completed exceptionally or a completion computation threw an exception | ### minimalCompletionStage Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletionStage minimalCompletionStage () ``` Returns a new CompletionStage that is completed normally with the same value as this CompletableFuture when it completes normally, and cannot be independently completed or otherwise used in ways not defined by the methods of interface[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage). If this CompletableFuture completes exceptionally, then the returned CompletionStage completes exceptionally with a CompletionException with this exception as cause. Unless overridden by a subclass, a new non-minimal CompletableFuture with all methods available can be obtained from a minimal CompletionStage via[toCompletableFuture()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#toCompletableFuture()). For example, completion of a minimal stage can be awaited by minimalStage.toCompletableFuture().join();

| Returns || |------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)`` | the new CompletionStage
| ### newIncompleteFuture Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture newIncompleteFuture () ``` Returns a new incomplete CompletableFuture of the type to be returned by a CompletionStage method. Subclasses should normally override this method to return an instance of the same class as this CompletableFuture. The default implementation returns an instance of class CompletableFuture.
| Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | a new CompletableFuture
| ### obtrudeException Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void obtrudeException (Throwable ex) ``` Forcibly causes subsequent invocations of method[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods to throw the given exception, whether or not already completed. This method is designed for use only in error recovery actions, and even in such situations may result in ongoing dependent completions using established versus overwritten outcomes.
| Parameters || |------|-----------------------------------| | `ex` | `Throwable`: the exception
| | Throws || |------------------------------------------------------------------------------------------------|--------------------------| | [NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException) | if the exception is null | ### obtrudeValue Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void obtrudeValue (T value) ``` Forcibly sets or resets the value subsequently returned by method[get()](https://developer.android.com/reference/java/util/concurrent/CompletableFuture#get())and related methods, whether or not already completed. This method is designed for use only in error recovery actions, and even in such situations may result in ongoing dependent completions using established versus overwritten outcomes.
| Parameters || |---------|----------------------------------| | `value` | `T`: the completion value
| ### orTimeout Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture orTimeout (long timeout, TimeUnit unit) ``` Exceptionally completes this CompletableFuture with a[TimeoutException](https://developer.android.com/reference/java/util/concurrent/TimeoutException)if not otherwise completed before the given timeout.
| Parameters || |-----------|------------------------------------------------------------------------------------------------------------| | `timeout` | `long`: how long to wait before completing exceptionally with a TimeoutException, in units of`unit`
| | `unit` | `TimeUnit`: a`TimeUnit`determining how to interpret the`timeout`parameter
| | Returns || |----------------------------------------------------------------------------------------------------------|-------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | this CompletableFuture
| ### resultNow Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public T resultNow () ``` Returns the computed result, without waiting. This method is for cases where the caller knows that the task has already completed successfully, for example when filtering a stream of Future objects for the successful tasks and using a mapping operation to obtain a stream of results.`lang=java : results = futures.stream() .filter(f -> f.state() == Future.State.SUCCESS) .map(Future::resultNow) .toList(); `
| Returns || |-----|----------------------------| | `T` | the computed result
| ### runAfterBoth Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterBoth (CompletionStage other, Runnable action) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAfterBothAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterBothAsync (CompletionStage other, Runnable action) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using this stage's default asynchronous execution facility. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAfterBothAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterBothAsync (CompletionStage other, Runnable action, Executor executor) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, executes the given action using the supplied executor. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAfterEither Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterEither (CompletionStage other, Runnable action) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAfterEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterEitherAsync (CompletionStage other, Runnable action, Executor executor) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using the supplied executor. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAfterEitherAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture runAfterEitherAsync (CompletionStage other, Runnable action) ``` Returns a new CompletionStage that, when either this or the other given stage complete normally, executes the given action using this stage's default asynchronous execution facility. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### runAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture runAsync (Runnable runnable) ``` Returns a new CompletableFuture that is asynchronously completed by a task running in the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())after it runs the given action.
| Parameters || |------------|---------------------------------------------------------------------------------------| | `runnable` | `Runnable`: the action to run before completing the returned CompletableFuture
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletableFuture
| ### runAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture runAsync (Runnable runnable, Executor executor) ``` Returns a new CompletableFuture that is asynchronously completed by a task running in the given executor after it runs the given action.
| Parameters || |------------|---------------------------------------------------------------------------------------| | `runnable` | `Runnable`: the action to run before completing the returned CompletableFuture
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletableFuture
| ### state Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public Future.State state () ```

| Returns || |-------------------------------------------------------------------------------------------|------------------------------| | [Future.State](https://developer.android.com/reference/java/util/concurrent/Future.State) | the computation state
| ### supplyAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture supplyAsync (Supplier supplier) ``` Returns a new CompletableFuture that is asynchronously completed by a task running in the[ForkJoinPool.commonPool()](https://developer.android.com/reference/java/util/concurrent/ForkJoinPool#commonPool())with the value obtained by calling the given Supplier.
| Parameters || |------------|---------------------------------------------------------------------------------------------------------| | `supplier` | `Supplier`: a function returning the value to be used to complete the returned CompletableFuture
| | Returns || |----------------------------------------------------------------------------------------------------------|----------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletableFuture
| ### supplyAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static CompletableFuture supplyAsync (Supplier supplier, Executor executor) ``` Returns a new CompletableFuture that is asynchronously completed by a task running in the given executor with the value obtained by calling the given Supplier.
| Parameters || |------------|---------------------------------------------------------------------------------------------------------| | `supplier` | `Supplier`: a function returning the value to be used to complete the returned CompletableFuture
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|----------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletableFuture
| ### thenAccept Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAccept (Consumer action) ``` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenAcceptAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAcceptAsync (Consumer action, Executor executor) ``` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenAcceptAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAcceptAsync (Consumer action) ``` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `action` | `Consumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenAcceptBoth Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAcceptBoth (CompletionStage other, BiConsumer action) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `BiConsumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenAcceptBothAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAcceptBothAsync (CompletionStage other, BiConsumer action, Executor executor) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `BiConsumer`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenAcceptBothAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenAcceptBothAsync (CompletionStage other, BiConsumer action) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `action` | `BiConsumer`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenApply Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenApply (Function fn) ``` Returns a new CompletionStage that, when this stage completes normally, is executed with this stage's result as the argument to the supplied function. This method is analogous to[Optional.map](https://developer.android.com/reference/java/util/Optional#map(java.util.function.Function))and[Stream.map](https://developer.android.com/reference/java/util/stream/Stream#map(java.util.function.Function)). See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------|---------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenApplyAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenApplyAsync (Function fn, Executor executor) ``` Returns a new CompletionStage that, when this stage completes normally, is executed using the supplied Executor, with this stage's result as the argument to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|---------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenApplyAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenApplyAsync (Function fn) ``` Returns a new CompletionStage that, when this stage completes normally, is executed using this stage's default asynchronous execution facility, with this stage's result as the argument to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------|---------------------------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenCombine Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenCombine (CompletionStage other, BiFunction fn) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed with the two results as arguments to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |---------|-----------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenCombineAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenCombineAsync (CompletionStage other, BiFunction fn, Executor executor) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using the supplied executor, with the two results as arguments to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenCombineAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenCombineAsync (CompletionStage other, BiFunction fn) ``` Returns a new CompletionStage that, when this and the other given stage both complete normally, is executed using this stage's default asynchronous execution facility, with the two results as arguments to the supplied function. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |---------|-----------------------------------------------------------------------------------------------| | `other` | `CompletionStage`: the other CompletionStage
| | `fn` | `BiFunction`: the function to use to compute the value of the returned CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenCompose Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenCompose (Function> fn) ``` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function. When this stage completes normally, the given function is invoked with this stage's result as the argument, returning another CompletionStage. When that stage completes normally, the CompletionStage returned by this method is completed with the same value. To ensure progress, the supplied function must arrange eventual completion of its result. This method is analogous to[Optional.flatMap](https://developer.android.com/reference/java/util/Optional#flatMap(java.util.function.Function>))and[Stream.flatMap](https://developer.android.com/reference/java/util/stream/Stream#flatMap(java.util.function.Function>)). See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------|---------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute another CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenComposeAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenComposeAsync (Function> fn) ``` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using this stage's default asynchronous execution facility. When this stage completes normally, the given function is invoked with this stage's result as the argument, returning another CompletionStage. When that stage completes normally, the CompletionStage returned by this method is completed with the same value. To ensure progress, the supplied function must arrange eventual completion of its result. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------|---------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute another CompletionStage
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenComposeAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenComposeAsync (Function> fn, Executor executor) ``` Returns a new CompletionStage that is completed with the same value as the CompletionStage returned by the given function, executed using the supplied Executor. When this stage completes normally, the given function is invoked with this stage's result as the argument, returning another CompletionStage. When that stage completes normally, the CompletionStage returned by this method is completed with the same value. To ensure progress, the supplied function must arrange eventual completion of its result. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|---------------------------------------------------------------------------| | `fn` | `Function`: the function to use to compute another CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### thenRun Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenRun (Runnable action) ``` Returns a new CompletionStage that, when this stage completes normally, executes the given action. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenRunAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenRunAsync (Runnable action, Executor executor) ``` Returns a new CompletionStage that, when this stage completes normally, executes the given action using the supplied Executor. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |------------|-----------------------------------------------------------------------------------------| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### thenRunAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture thenRunAsync (Runnable action) ``` Returns a new CompletionStage that, when this stage completes normally, executes the given action using this stage's default asynchronous execution facility. See the[CompletionStage](https://developer.android.com/reference/java/util/concurrent/CompletionStage)documentation for rules covering exceptional completion.
| Parameters || |----------|-----------------------------------------------------------------------------------------| | `action` | `Runnable`: the action to perform before completing the returned CompletionStage
| | Returns || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`<`[Void](https://developer.android.com/reference/java/lang/Void)`>` | the new CompletionStage
| ### toCompletableFuture Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture toCompletableFuture () ``` Returns this CompletableFuture.
| Returns || |----------------------------------------------------------------------------------------------------------|-------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | this CompletableFuture
| ### toString Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public String toString () ``` Returns a string identifying this CompletableFuture, as well as its completion state. The state, in brackets, contains the String`"Completed Normally"`or the String`"Completed Exceptionally"`, or the String`"Not completed"`followed by the number of CompletableFutures dependent upon its completion, if any.
| Returns || |--------------------------------------------------------------------|--------------------------------------------------------------------------| | [String](https://developer.android.com/reference/java/lang/String) | a string identifying this CompletableFuture, as well as its state
| ### whenComplete Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture whenComplete (BiConsumer action) ``` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action when this stage completes. When this stage is complete, the given action is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments. The returned stage is completed when the action returns. Unlike method[handle](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handle(java.util.function.BiFunction)), this method is not designed to translate completion outcomes, so the supplied action should not throw an exception. However, if it does, the following rules apply: if this stage completed normally but the supplied action throws an exception, then the returned stage completes exceptionally with the supplied action's exception. Or, if this stage completed exceptionally and the supplied action throws an exception, then the returned stage completes exceptionally with this stage's exception.
| Parameters || |----------|--------------------------------------------| | `action` | `BiConsumer`: the action to perform
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### whenCompleteAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture whenCompleteAsync (BiConsumer action, Executor executor) ``` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using the supplied Executor when this stage completes. When this stage is complete, the given action is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments. The returned stage is completed when the action returns. Unlike method[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handleAsync(java.util.function.BiFunction,%20java.util.concurrent.Executor)), this method is not designed to translate completion outcomes, so the supplied action should not throw an exception. However, if it does, the following rules apply: If this stage completed normally but the supplied action throws an exception, then the returned stage completes exceptionally with the supplied action's exception. Or, if this stage completed exceptionally and the supplied action throws an exception, then the returned stage completes exceptionally with this stage's exception.
| Parameters || |------------|-------------------------------------------------------------------| | `action` | `BiConsumer`: the action to perform
| | `executor` | `Executor`: the executor to use for asynchronous execution
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
| ### whenCompleteAsync Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public CompletableFuture whenCompleteAsync (BiConsumer action) ``` Returns a new CompletionStage with the same result or exception as this stage, that executes the given action using this stage's default asynchronous execution facility when this stage completes. When this stage is complete, the given action is invoked with the result (or`null`if none) and the exception (or`null`if none) of this stage as arguments. The returned stage is completed when the action returns. Unlike method[handleAsync](https://developer.android.com/reference/java/util/concurrent/CompletionStage#handleAsync(java.util.function.BiFunction)), this method is not designed to translate completion outcomes, so the supplied action should not throw an exception. However, if it does, the following rules apply: If this stage completed normally but the supplied action throws an exception, then the returned stage completes exceptionally with the supplied action's exception. Or, if this stage completed exceptionally and the supplied action throws an exception, then the returned stage completes exceptionally with this stage's exception.
| Parameters || |----------|--------------------------------------------| | `action` | `BiConsumer`: the action to perform
| | Returns || |----------------------------------------------------------------------------------------------------------|--------------------------------| | [CompletableFuture](https://developer.android.com/reference/java/util/concurrent/CompletableFuture)`` | the new CompletionStage
|