org.skfiy.util.v8

类 CompletableFuture<T>

java.lang.Object

org.skfiy.util.v8.CompletableFuture<T>

所有已实现的接口:

Future<T>

public class CompletableFuture<T>
extends Object
implements Future<T>

A Future that may be explicitly completed (setting its value and status), and may include dependent functions and actions that trigger upon its completion. Methods are available for adding those based on Functions, Blocks, and Runnables, depending on whether they require arguments and/or produce results, as well as those triggered after either or both the current and another CompletableFuture complete. Functions and actions supplied for dependent completions (mainly using methods with prefix then) may be performed by the thread that completes the current CompletableFuture, or by any other caller of these methods. There are no guarantees about the order of processing completions unless constrained by these methods.

When two or more threads attempt to complete(T) or completeExceptionally(java.lang.Throwable) a CompletableFuture, only one of them succeeds.

Upon exceptional completion, or when a completion entails computation of a function or action, and it terminates abruptly with an (unchecked) exception or error, then further completions act as completeExceptionally with a CompletionException holding that exception as its cause. If a CompletableFuture completes exceptionally, and is not followed by a exceptionally(org.skfiy.util.v8.CompletableFuture.Fun<java.lang.Throwable, ? extends T>) or handle(org.skfiy.util.v8.CompletableFuture.BiFun<? super T, java.lang.Throwable, ? extends U>) completion, then all of its dependents (and their dependents) also complete exceptionally with CompletionExceptions holding the ultimate cause. In case of a CompletionException, methods get() and get(long, TimeUnit) throw an ExecutionException with the same cause as would be held in the corresponding CompletionException. However, in these cases, methods join() and getNow(T) throw the CompletionException, which simplifies usage especially within other completion functions.

CompletableFutures themselves do not execute asynchronously. However, the async methods provide commonly useful ways to commence asynchronous processing, using either a given Executor or by default the ForkJoinPool.commonPool(), of a function or action that will result in the completion of a new CompletableFuture. To simplify monitoring, debugging, and tracking, all generated asynchronous tasks are instances of the marker interface CompletableFuture.AsynchronousCompletionTask.

jsr166e note: During transition, this class uses nested functional interfaces with different names but the same forms as those expected for JDK8.

从以下版本开始:

1.8

作者:

Doug Lea

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	CompletableFuture.Action<A> Interface describing a void action of one argument
static interface	CompletableFuture.AsynchronousCompletionTask A marker interface identifying asynchronous tasks produced by async methods.
static interface	CompletableFuture.BiAction<A,B> Interface describing a void action of two arguments
static interface	CompletableFuture.BiFun<A,B,T> Interface describing a function of two arguments
static interface	CompletableFuture.Fun<A,T> Interface describing a function of one argument
static interface	CompletableFuture.Generator<T> Interface describing a function of no arguments

构造器概要

构造器

构造器和说明
CompletableFuture() Creates a new incomplete CompletableFuture.

方法概要

方法

限定符和类型	方法和说明
CompletableFuture<Void>	acceptEither(CompletableFuture<? extends T> other, CompletableFuture.Action<? super T> block) Creates and returns a CompletableFuture that is completed after performing the given action with the result of either this or the other given CompletableFuture's result, when either complete.
CompletableFuture<Void>	acceptEitherAsync(CompletableFuture<? extends T> other, CompletableFuture.Action<? super T> block) Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool(), performing the given action with the result of either this or the other given CompletableFuture's result, when either complete.
CompletableFuture<Void>	acceptEitherAsync(CompletableFuture<? extends T> other, CompletableFuture.Action<? super T> block, Executor executor) Creates and returns a CompletableFuture that is completed asynchronously using the given executor, performing the given action with the result of either this or the other given CompletableFuture's result, when either complete.
<U> CompletableFuture<U>	applyToEither(CompletableFuture<? extends T> other, CompletableFuture.Fun<? super T,U> fn) Creates and returns a CompletableFuture that is completed with the result of the given function of either this or the other given CompletableFuture's results when either complete.
<U> CompletableFuture<U>	applyToEitherAsync(CompletableFuture<? extends T> other, CompletableFuture.Fun<? super T,U> fn) Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() with the result of the given function of either this or the other given CompletableFuture's results when either complete.
<U> CompletableFuture<U>	applyToEitherAsync(CompletableFuture<? extends T> other, CompletableFuture.Fun<? super T,U> fn, Executor executor) Creates and returns a CompletableFuture that is completed asynchronously using the given executor with the result of the given function of either this or the other given CompletableFuture's results when either complete.
boolean	cancel(boolean mayInterruptIfRunning) Attempts to complete this CompletableFuture with a CancellationException.
boolean	complete(T value) If not already completed, sets the value returned by get() and related methods to the given value.
boolean	completeExceptionally(Throwable ex) If not already completed, causes invocations of get() and related methods to throw the given exception.
CompletableFuture<T>	exceptionally(CompletableFuture.Fun<Throwable,? extends T> fn) Creates and returns a CompletableFuture that is completed with the result of the given function of the exception triggering this CompletableFuture's completion when it completes exceptionally; Otherwise, if this CompletableFuture completes normally, then the returned CompletableFuture also completes normally with the same value.
T	get() Waits if necessary for the computation to complete, and then retrieves its result.
T	get(long timeout, TimeUnit unit) Waits if necessary for at most the given time for completion, and then retrieves its result, if available.
T	getNow(T valueIfAbsent) Returns the result value (or throws any encountered exception) if completed, else returns the given valueIfAbsent.
<U> CompletableFuture<U>	handle(CompletableFuture.BiFun<? super T,Throwable,? extends U> fn) Creates and returns a CompletableFuture that is completed with the result of the given function of the result and exception of this CompletableFuture's completion when it completes.
boolean	isCancelled() Returns true if this CompletableFuture was cancelled before it completed normally.
boolean	isDone() Returns true if completed in any fashion: normally, exceptionally, or via cancellation.
T	join() Returns the result value when complete, or throws an (unchecked) exception if completed exceptionally.
void	obtrudeException(Throwable ex) Forcibly causes subsequent invocations of method get() and related methods to throw the given exception, whether or not already completed.
void	obtrudeValue(T value) Forcibly sets or resets the value subsequently returned by method get() and related methods, whether or not already completed.
CompletableFuture<Void>	runAfterBoth(CompletableFuture<?> other, Runnable action) Creates and returns a CompletableFuture that is completed when this and the other given CompletableFuture both complete.
CompletableFuture<Void>	runAfterBothAsync(CompletableFuture<?> other, Runnable action) Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() when this and the other given CompletableFuture both complete.
CompletableFuture<Void>	runAfterBothAsync(CompletableFuture<?> other, Runnable action, Executor executor) Creates and returns a CompletableFuture that is completed asynchronously using the given executor when this and the other given CompletableFuture both complete.
CompletableFuture<Void>	runAfterEither(CompletableFuture<?> other, Runnable action) Creates and returns a CompletableFuture that is completed after this or the other given CompletableFuture complete.
CompletableFuture<Void>	runAfterEitherAsync(CompletableFuture<?> other, Runnable action) Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() after this or the other given CompletableFuture complete.
CompletableFuture<Void>	runAfterEitherAsync(CompletableFuture<?> other, Runnable action, Executor executor) Creates and returns a CompletableFuture that is completed asynchronously using the given executor after this or the other given CompletableFuture complete.
static CompletableFuture<Void>	runAsync(Runnable runnable) Asynchronously executes in the ForkJoinPool.commonPool() a task that runs the given action, and then completes the returned CompletableFuture.
static CompletableFuture<Void>	runAsync(Runnable runnable, Executor executor) Asynchronously executes using the given executor, a task that runs the given action, and then completes the returned CompletableFuture.
static <U> CompletableFuture<U>	supplyAsync(CompletableFuture.Generator<U> supplier) Asynchronously executes in the ForkJoinPool.commonPool(), a task that completes the returned CompletableFuture with the result of the given Supplier.
static <U> CompletableFuture<U>	supplyAsync(CompletableFuture.Generator<U> supplier, Executor executor) Asynchronously executes using the given executor, a task that completes the returned CompletableFuture with the result of the given Supplier.
CompletableFuture<Void>	thenAccept(CompletableFuture.Action<? super T> block) Creates and returns a CompletableFuture that is completed after performing the given action with this CompletableFuture's result when it completes.
CompletableFuture<Void>	thenAcceptAsync(CompletableFuture.Action<? super T> block) Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with this CompletableFuture's result when it completes.
CompletableFuture<Void>	thenAcceptAsync(CompletableFuture.Action<? super T> block, Executor executor) Creates and returns a CompletableFuture that is asynchronously completed using the given executor with this CompletableFuture's result when it completes.
<U> CompletableFuture<Void>	thenAcceptBoth(CompletableFuture<? extends U> other, CompletableFuture.BiAction<? super T,? super U> block) Creates and returns a CompletableFuture that is completed with the results of this and the other given CompletableFuture if both complete.
<U> CompletableFuture<Void>	thenAcceptBothAsync(CompletableFuture<? extends U> other, CompletableFuture.BiAction<? super T,? super U> block) Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() with the results of this and the other given CompletableFuture when both complete.
<U> CompletableFuture<Void>	thenAcceptBothAsync(CompletableFuture<? extends U> other, CompletableFuture.BiAction<? super T,? super U> block, Executor executor) Creates and returns a CompletableFuture that is completed asynchronously using the given executor with the results of this and the other given CompletableFuture when both complete.
<U> CompletableFuture<U>	thenApply(CompletableFuture.Fun<? super T,? extends U> fn) Creates and returns a CompletableFuture that is completed with the result of the given function of this CompletableFuture.
<U> CompletableFuture<U>	thenApplyAsync(CompletableFuture.Fun<? super T,? extends U> fn) Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with the result of the given function of this CompletableFuture.
<U> CompletableFuture<U>	thenApplyAsync(CompletableFuture.Fun<? super T,? extends U> fn, Executor executor) Creates and returns a CompletableFuture that is asynchronously completed using the given executor with the result of the given function of this CompletableFuture.
<U,V> CompletableFuture<V>	thenCombine(CompletableFuture<? extends U> other, CompletableFuture.BiFun<? super T,? super U,? extends V> fn) Creates and returns a CompletableFuture that is completed with the result of the given function of this and the other given CompletableFuture's results when both complete.
<U,V> CompletableFuture<V>	thenCombineAsync(CompletableFuture<? extends U> other, CompletableFuture.BiFun<? super T,? super U,? extends V> fn) Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with the result of the given function of this and the other given CompletableFuture's results when both complete.
<U,V> CompletableFuture<V>	thenCombineAsync(CompletableFuture<? extends U> other, CompletableFuture.BiFun<? super T,? super U,? extends V> fn, Executor executor) Creates and returns a CompletableFuture that is asynchronously completed using the given executor with the result of the given function of this and the other given CompletableFuture's results when both complete.
<U> CompletableFuture<U>	thenCompose(CompletableFuture.Fun<? super T,CompletableFuture<U>> fn) Returns a CompletableFuture (or an equivalent one) produced by the given function of the result of this CompletableFuture when completed.
CompletableFuture<Void>	thenRun(Runnable action) Creates and returns a CompletableFuture that is completed after performing the given action when this CompletableFuture completes.
CompletableFuture<Void>	thenRunAsync(Runnable action) Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() after performing the given action when this CompletableFuture completes.
CompletableFuture<Void>	thenRunAsync(Runnable action, Executor executor) Creates and returns a CompletableFuture that is asynchronously completed using the given executor after performing the given action when this CompletableFuture completes.

从类继承的方法 java.lang.Object

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

构造器详细资料

CompletableFuture

public CompletableFuture()

Creates a new incomplete CompletableFuture.

方法详细资料

supplyAsync

public static <U> CompletableFuture<U> supplyAsync(CompletableFuture.Generator<U> supplier)

Asynchronously executes in the ForkJoinPool.commonPool(), a task that completes the returned CompletableFuture with the result of the given Supplier.

参数:

supplier - a function returning the value to be used to complete the returned CompletableFuture

返回:

the CompletableFuture

supplyAsync

public static <U> CompletableFuture<U> supplyAsync(CompletableFuture.Generator<U> supplier,
                                   Executor executor)

Asynchronously executes using the given executor, a task that completes the returned CompletableFuture with the result of the given Supplier.

参数:

supplier - a function returning the value to be used to complete the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the CompletableFuture

runAsync

public static CompletableFuture<Void> runAsync(Runnable runnable)

Asynchronously executes in the ForkJoinPool.commonPool() a task that runs the given action, and then completes the returned CompletableFuture.

参数:

runnable - the action to run before completing the returned CompletableFuture

返回:

the CompletableFuture

runAsync

public static CompletableFuture<Void> runAsync(Runnable runnable,
                               Executor executor)

Asynchronously executes using the given executor, a task that runs the given action, and then completes the returned CompletableFuture.

参数:

runnable - the action to run before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the CompletableFuture

isDone

public boolean isDone()

Returns true if completed in any fashion: normally, exceptionally, or via cancellation.

指定者:

isDone 在接口中 Future<T>

返回:

true if completed

get

public T get()
      throws InterruptedException,
             ExecutionException

Waits if necessary for the computation to complete, and then retrieves its result.

指定者:

get 在接口中 Future<T>

返回:

the computed result

抛出:

CancellationException - if the computation was cancelled

ExecutionException - if the computation threw an exception

InterruptedException - if the current thread was interrupted while waiting

get

public T get(long timeout,
    TimeUnit unit)
      throws InterruptedException,
             ExecutionException,
             TimeoutException

Waits if necessary for at most the given time for completion, and then retrieves its result, if available.

指定者:

get 在接口中 Future<T>

参数:

timeout - the maximum time to wait

unit - the time unit of the timeout argument

返回:

the computed result

抛出:

CancellationException - if the computation was cancelled

ExecutionException - if the computation threw an exception

InterruptedException - if the current thread was interrupted while waiting

TimeoutException - if the wait timed out

join

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 with the underlying exception as its cause.

返回:

the result value

抛出:

CancellationException - if the computation was cancelled

CompletionException - if a completion computation threw an exception

getNow

public T getNow(T valueIfAbsent)

Returns the result value (or throws any encountered exception) if completed, else returns the given valueIfAbsent.

参数:

valueIfAbsent - the value to return if not completed

返回:

the result value, if completed, else the given valueIfAbsent

抛出:

CancellationException - if the computation was cancelled

CompletionException - if a completion computation threw an exception

complete

public boolean complete(T value)

If not already completed, sets the value returned by get() and related methods to the given value.

参数:

value - the result value

返回:

true if this invocation caused this CompletableFuture to transition to a completed state, else false

completeExceptionally

public boolean completeExceptionally(Throwable ex)

If not already completed, causes invocations of get() and related methods to throw the given exception.

参数:

ex - the exception

返回:

true if this invocation caused this CompletableFuture to transition to a completed state, else false

thenApply

public <U> CompletableFuture<U> thenApply(CompletableFuture.Fun<? super T,? extends U> fn)

Creates and returns a CompletableFuture that is completed with the result of the given function of this CompletableFuture. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

thenApplyAsync

public <U> CompletableFuture<U> thenApplyAsync(CompletableFuture.Fun<? super T,? extends U> fn)

Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with the result of the given function of this CompletableFuture. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

thenApplyAsync

public <U> CompletableFuture<U> thenApplyAsync(CompletableFuture.Fun<? super T,? extends U> fn,
                                      Executor executor)

Creates and returns a CompletableFuture that is asynchronously completed using the given executor with the result of the given function of this CompletableFuture. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

fn - the function to use to compute the value of the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

thenAccept

public CompletableFuture<Void> thenAccept(CompletableFuture.Action<? super T> block)

Creates and returns a CompletableFuture that is completed after performing the given action with this CompletableFuture's result when it completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenAcceptAsync

public CompletableFuture<Void> thenAcceptAsync(CompletableFuture.Action<? super T> block)

Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with this CompletableFuture's result when it completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenAcceptAsync

public CompletableFuture<Void> thenAcceptAsync(CompletableFuture.Action<? super T> block,
                                      Executor executor)

Creates and returns a CompletableFuture that is asynchronously completed using the given executor with this CompletableFuture's result when it completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

block - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

thenRun

public CompletableFuture<Void> thenRun(Runnable action)

Creates and returns a CompletableFuture that is completed after performing the given action when this CompletableFuture completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenRunAsync

public CompletableFuture<Void> thenRunAsync(Runnable action)

Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() after performing the given action when this CompletableFuture completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenRunAsync

public CompletableFuture<Void> thenRunAsync(Runnable action,
                                   Executor executor)

Creates and returns a CompletableFuture that is asynchronously completed using the given executor after performing the given action when this CompletableFuture completes. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

action - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

thenCombine

public <U,V> CompletableFuture<V> thenCombine(CompletableFuture<? extends U> other,
                                     CompletableFuture.BiFun<? super T,? super U,? extends V> fn)

Creates and returns a CompletableFuture that is completed with the result of the given function of this and the other given CompletableFuture's results when both complete. If this or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding the exception as its cause.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

thenCombineAsync

public <U,V> CompletableFuture<V> thenCombineAsync(CompletableFuture<? extends U> other,
                                          CompletableFuture.BiFun<? super T,? super U,? extends V> fn)

Creates and returns a CompletableFuture that is asynchronously completed using the ForkJoinPool.commonPool() with the result of the given function of this and the other given CompletableFuture's results when both complete. If this or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding the exception as its cause.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

thenCombineAsync

public <U,V> CompletableFuture<V> thenCombineAsync(CompletableFuture<? extends U> other,
                                          CompletableFuture.BiFun<? super T,? super U,? extends V> fn,
                                          Executor executor)

Creates and returns a CompletableFuture that is asynchronously completed using the given executor with the result of the given function of this and the other given CompletableFuture's results when both complete. If this or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding the exception as its cause.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

thenAcceptBoth

public <U> CompletableFuture<Void> thenAcceptBoth(CompletableFuture<? extends U> other,
                                         CompletableFuture.BiAction<? super T,? super U> block)

Creates and returns a CompletableFuture that is completed with the results of this and the other given CompletableFuture if both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenAcceptBothAsync

public <U> CompletableFuture<Void> thenAcceptBothAsync(CompletableFuture<? extends U> other,
                                              CompletableFuture.BiAction<? super T,? super U> block)

Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() with the results of this and the other given CompletableFuture when both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

thenAcceptBothAsync

public <U> CompletableFuture<Void> thenAcceptBothAsync(CompletableFuture<? extends U> other,
                                              CompletableFuture.BiAction<? super T,? super U> block,
                                              Executor executor)

Creates and returns a CompletableFuture that is completed asynchronously using the given executor with the results of this and the other given CompletableFuture when both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

runAfterBoth

public CompletableFuture<Void> runAfterBoth(CompletableFuture<?> other,
                                   Runnable action)

Creates and returns a CompletableFuture that is completed when this and the other given CompletableFuture both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

runAfterBothAsync

public CompletableFuture<Void> runAfterBothAsync(CompletableFuture<?> other,
                                        Runnable action)

Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() when this and the other given CompletableFuture both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

runAfterBothAsync

public CompletableFuture<Void> runAfterBothAsync(CompletableFuture<?> other,
                                        Runnable action,
                                        Executor executor)

Creates and returns a CompletableFuture that is completed asynchronously using the given executor when this and the other given CompletableFuture both complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding one of these exceptions as its cause.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

applyToEither

public <U> CompletableFuture<U> applyToEither(CompletableFuture<? extends T> other,
                                     CompletableFuture.Fun<? super T,U> fn)

Creates and returns a CompletableFuture that is completed with the result of the given function of either this or the other given CompletableFuture's results when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which result or exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

applyToEitherAsync

public <U> CompletableFuture<U> applyToEitherAsync(CompletableFuture<? extends T> other,
                                          CompletableFuture.Fun<? super T,U> fn)

Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() with the result of the given function of either this or the other given CompletableFuture's results when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which result or exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

applyToEitherAsync

public <U> CompletableFuture<U> applyToEitherAsync(CompletableFuture<? extends T> other,
                                          CompletableFuture.Fun<? super T,U> fn,
                                          Executor executor)

Creates and returns a CompletableFuture that is completed asynchronously using the given executor with the result of the given function of either this or the other given CompletableFuture's results when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which result or exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

fn - the function to use to compute the value of the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

acceptEither

public CompletableFuture<Void> acceptEither(CompletableFuture<? extends T> other,
                                   CompletableFuture.Action<? super T> block)

Creates and returns a CompletableFuture that is completed after performing the given action with the result of either this or the other given CompletableFuture's result, when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

acceptEitherAsync

public CompletableFuture<Void> acceptEitherAsync(CompletableFuture<? extends T> other,
                                        CompletableFuture.Action<? super T> block)

Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool(), performing the given action with the result of either this or the other given CompletableFuture's result, when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

acceptEitherAsync

public CompletableFuture<Void> acceptEitherAsync(CompletableFuture<? extends T> other,
                                        CompletableFuture.Action<? super T> block,
                                        Executor executor)

Creates and returns a CompletableFuture that is completed asynchronously using the given executor, performing the given action with the result of either this or the other given CompletableFuture's result, when either complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

block - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

runAfterEither

public CompletableFuture<Void> runAfterEither(CompletableFuture<?> other,
                                     Runnable action)

Creates and returns a CompletableFuture that is completed after this or the other given CompletableFuture complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

runAfterEitherAsync

public CompletableFuture<Void> runAfterEitherAsync(CompletableFuture<?> other,
                                          Runnable action)

Creates and returns a CompletableFuture that is completed asynchronously using the ForkJoinPool.commonPool() after this or the other given CompletableFuture complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

返回:

the new CompletableFuture

runAfterEitherAsync

public CompletableFuture<Void> runAfterEitherAsync(CompletableFuture<?> other,
                                          Runnable action,
                                          Executor executor)

Creates and returns a CompletableFuture that is completed asynchronously using the given executor after this or the other given CompletableFuture complete. If this and/or the other CompletableFuture complete exceptionally, then the returned CompletableFuture may also do so, with a CompletionException holding one of these exceptions as its cause. No guarantees are made about which exception is used in the returned CompletableFuture.

参数:

other - the other CompletableFuture

action - the action to perform before completing the returned CompletableFuture

executor - the executor to use for asynchronous execution

返回:

the new CompletableFuture

thenCompose

public <U> CompletableFuture<U> thenCompose(CompletableFuture.Fun<? super T,CompletableFuture<U>> fn)

Returns a CompletableFuture (or an equivalent one) produced by the given function of the result of this CompletableFuture when completed. If this CompletableFuture completes exceptionally, then the returned CompletableFuture also does so, with a CompletionException holding this exception as its cause.

参数:

fn - the function returning a new CompletableFuture

返回:

the CompletableFuture, that isDone() upon return if completed by the given function, or an exception occurs

exceptionally

public CompletableFuture<T> exceptionally(CompletableFuture.Fun<Throwable,? extends T> fn)

Creates and returns a CompletableFuture that is completed with the result of the given function of the exception triggering this CompletableFuture's completion when it completes exceptionally; Otherwise, if this CompletableFuture completes normally, then the returned CompletableFuture also completes normally with the same value.

参数:

fn - the function to use to compute the value of the returned CompletableFuture if this CompletableFuture completed exceptionally

返回:

the new CompletableFuture

handle

public <U> CompletableFuture<U> handle(CompletableFuture.BiFun<? super T,Throwable,? extends U> fn)

Creates and returns a CompletableFuture that is completed with the result of the given function of the result and exception of this CompletableFuture's completion when it completes. The given function is invoked with the result (or null if none) and the exception (or null if none) of this CompletableFuture when complete.

参数:

fn - the function to use to compute the value of the returned CompletableFuture

返回:

the new CompletableFuture

cancel

public boolean cancel(boolean mayInterruptIfRunning)

Attempts to complete this CompletableFuture with a CancellationException.

指定者:

cancel 在接口中 Future<T>

参数:

mayInterruptIfRunning - this value has no effect in this implementation because interrupts are not used to control processing.

返回:

true if this task is now cancelled

isCancelled

public boolean isCancelled()

Returns true if this CompletableFuture was cancelled before it completed normally.

指定者:

isCancelled 在接口中 Future<T>

返回:

true if this CompletableFuture was cancelled before it completed normally

obtrudeValue

public void obtrudeValue(T value)

Forcibly sets or resets the value subsequently returned by method 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.

参数:

value - the completion value

obtrudeException

public void obtrudeException(Throwable ex)

Forcibly causes subsequent invocations of method get() and related methods to throw the given exception, whether or not already completed. This method is designed for use only in recovery actions, and even in such situations may result in ongoing dependent completions using established versus overwritten outcomes.

参数:

ex - the exception