模块 wjybxx.commons.concurrent

程序包 cn.wjybxx.concurrent

类 Promise<T>

java.lang.Object

cn.wjybxx.concurrent.Promise<T>

所有已实现的接口:

ICompletionStage<T>, IFuture<T>, IPromise<T>, Future<T>

直接已知子类:

ScheduledPromise

@ThreadSafe
public class Promise<T>
extends Object
implements IPromise<T>, IFuture<T>

声明IFuture接口加快instanceof测试

作者:

wjybxx date - 2024/1/10

嵌套类概要

从接口继承的嵌套类/接口 java.util.concurrent.Future

Future.State

构造器概要

构造器

构造器	说明
Promise()
Promise(Executor executor)

方法概要

修饰符和类型	方法	说明
IFuture<T>	asReadonly()	返回只读的Future视图， 如果Future是一个提供了写接口的Promise，则返回一个只读的Future视图，返回的实例会在当前Promise进入完成状态时进入完成状态。
final Promise<T>	await()	阻塞到任务完成
final boolean	await(long timeout, TimeUnit unit)
final Promise<T>	awaitUninterruptibly()	阻塞到任务完成
final boolean	awaitUninterruptibly(long timeout, TimeUnit unit)
final boolean	cancel(boolean mayInterruptIfRunning)	已过时。
<X extends Throwable> Promise<T>	catching(Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends T> fallback)
<X extends Throwable> Promise<T>	catching(Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends T> fallback, IContext ctx, int options)	它表示能从从特定的异常中恢复，并返回一个正常结果。
<X extends Throwable> Promise<T>	catchingAsync(Executor executor, Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends T> fallback)
<X extends Throwable> Promise<T>	catchingAsync(Executor executor, Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends T> fallback, IContext ctx, int options)
protected final void	checkDeadlock()	死锁检查
static <V> Promise<V>	completedPromise(V result)
static <V> Promise<V>	completedPromise(V result, Executor executor)
<U> Promise<U>	composeApply(BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeApply(BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn, IContext ctx, int options)	该方法表示在当前Future与返回的Future中插入一个异步操作，构建异步管道 => 这是链式调用的核心API。
<U> Promise<U>	composeApplyAsync(Executor executor, BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeApplyAsync(Executor executor, BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn, IContext ctx, int options)
<U> Promise<U>	composeCall(Function<? super IContext,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeCall(Function<? super IContext,? extends ICompletionStage<U>> fn, IContext ctx, int options)	该方法表示在当前Future与返回的Future中插入一个异步操作，构建异步管道 该方法对应我们日常流中使用的Stream.flatMap(Function)操作。
<U> Promise<U>	composeCallAsync(Executor executor, Function<? super IContext,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeCallAsync(Executor executor, Function<? super IContext,? extends ICompletionStage<U>> fn, IContext ctx, int options)
<X extends Throwable> Promise<T>	composeCatching(Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback)
<X extends Throwable> Promise<T>	composeCatching(Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback, IContext ctx, int options)	它表示能从从特定的异常中恢复，并异步返回一个正常结果。
<X extends Throwable> Promise<T>	composeCatchingAsync(Executor executor, Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback)
<X extends Throwable> Promise<T>	composeCatchingAsync(Executor executor, Class<X> exceptionType, BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback, IContext ctx, int options)
<U> Promise<U>	composeHandle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeHandle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn, IContext ctx, int options)	它表示既能接收任务的正常结果，也可以接收任务异常结果，并异步返回一个运算结果。
<U> Promise<U>	composeHandleAsync(Executor executor, cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn)
<U> Promise<U>	composeHandleAsync(Executor executor, cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn, IContext ctx, int options)
final Throwable	exceptionNow()	非阻塞方式获取导致Future失败的原因，不适用被取消的Future； 如果需要获取取消异常，可使用IFuture.exceptionNow(boolean)。
final Throwable	exceptionNow(boolean throwIfCancelled)	获取导致任务失败的异常，可获取取消异常
Executor	executor()	允许重写
static <V> Promise<V>	failedPromise(Throwable cause)
static <V> Promise<V>	failedPromise(Throwable cause, Executor executor)
final T	get()
final T	get(long timeout, TimeUnit unit)
final T	getNow()	获取关联的计算结果 -- 非阻塞。
final T	getNow(T valueIfAbsent)	尝试获取计算结果 -- 非阻塞 如果对应的计算失败，则抛出对应的异常。
<U> Promise<U>	handle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn)
<U> Promise<U>	handle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn, IContext ctx, int options)	该方法表示既能处理当前计算的正常结果，又能处理当前结算的异常结果(可以将异常转换为新的结果)，并返回一个新的结果。
<U> Promise<U>	handleAsync(Executor executor, cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn)
<U> Promise<U>	handleAsync(Executor executor, cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn, IContext ctx, int options)
protected IContext	inheritContext(int options)
final boolean	isCancelled()	如果future关联的任务在正常完成被取消，则返回true。
final boolean	isComputing()	如果future关联的任务正在执行中，则返回true
final boolean	isDone()	如果future已进入完成状态(成功、失败、被取消)，则返回true
final boolean	isFailed()	如果future已进入完成状态，且是失败状态，则返回true
final boolean	isFailedOrCancelled()	在JDK的约定中，取消和failed是分离的，我们仍保持这样的约定； 但有些时候，我们需要将取消也视为失败的一种，因此需要快捷的方法。
final boolean	isPending()	如果future关联的任务仍处于等待执行的状态，则返回true （换句话说，如果任务仍在排队，则返回true）
boolean	isSucceeded()	如果future已进入完成状态，且是成功完成，则返回true。
final T	join()	阻塞到任务完成
protected <U> Promise<U>	newIncompletePromise(Executor exe)
void	onCompleted(BiConsumer<? super IFuture<T>,? super IContext> action, IContext context)
void	onCompleted(BiConsumer<? super IFuture<T>,? super IContext> action, IContext context, int options)	该接口支持Context参数，可响应取消
void	onCompleted(Consumer<? super IFuture<T>> action)
void	onCompleted(Consumer<? super IFuture<T>> action, int options)	最原始的Future监听接口 1.
void	onCompletedAsync(Executor executor, BiConsumer<? super IFuture<T>,? super IContext> action, IContext context)
void	onCompletedAsync(Executor executor, BiConsumer<? super IFuture<T>,? super IContext> action, IContext context, int options)
void	onCompletedAsync(Executor executor, Consumer<? super IFuture<T>> action)
void	onCompletedAsync(Executor executor, Consumer<? super IFuture<T>> action, int options)
final T	resultNow()	非阻塞方式获取Future的执行结果
void	setCancelled(int code)	将Future置为已取消状态，如果future已进入完成状态，则抛出IllegalStateException
final void	setComputing()	将future置为计算中状态，如果future之前不处于pending状态，则抛出IllegalStateException
final void	setException(Throwable cause)	将future置为失败状态，如果future已进入完成状态，则抛出IllegalStateException
final void	setResult(T result)	将future置为成功完成状态，如果future已进入完成状态，则抛出IllegalStateException
final Future.State	state()	已过时。
final TaskStatus	status()	future关联的任务的状态
Promise<Void>	thenAccept(BiConsumer<? super IContext,? super T> action)
Promise<Void>	thenAccept(BiConsumer<? super IContext,? super T> action, IContext ctx, int options)	该方法返回一个新的Future，它的结果由当前Future驱动。
Promise<Void>	thenAcceptAsync(Executor executor, BiConsumer<? super IContext,? super T> action)
Promise<Void>	thenAcceptAsync(Executor executor, BiConsumer<? super IContext,? super T> action, IContext ctx, int options)
<U> Promise<U>	thenApply(BiFunction<? super IContext,? super T,? extends U> fn)
<U> Promise<U>	thenApply(BiFunction<? super IContext,? super T,? extends U> fn, IContext ctx, int options)	该方法返回一个新的Future，它的结果由当前Future驱动。
<U> Promise<U>	thenApplyAsync(Executor executor, BiFunction<? super IContext,? super T,? extends U> fn)
<U> Promise<U>	thenApplyAsync(Executor executor, BiFunction<? super IContext,? super T,? extends U> fn, IContext ctx, int options)
<U> Promise<U>	thenCall(Function<? super IContext,? extends U> fn)
<U> Promise<U>	thenCall(Function<? super IContext,? extends U> fn, IContext ctx, int options)	该方法返回一个新的Future，它的结果由当前Future驱动。
<U> Promise<U>	thenCallAsync(Executor executor, Function<? super IContext,? extends U> fn)
<U> Promise<U>	thenCallAsync(Executor executor, Function<? super IContext,? extends U> fn, IContext ctx, int options)
Promise<Void>	thenRun(Consumer<? super IContext> action)
Promise<Void>	thenRun(Consumer<? super IContext> action, IContext ctx, int options)	该方法返回一个新的Future，它的结果由当前Future驱动。
Promise<Void>	thenRunAsync(Executor executor, Consumer<? super IContext> action)
Promise<Void>	thenRunAsync(Executor executor, Consumer<? super IContext> action, IContext ctx, int options)
IFuture<T>	toFuture()	返回一个Future，保持与这个Stage相同的完成结果。
boolean	trySetCancelled(int code)	将Future置为已取消状态，如果future已进入完成状态，则返回false
final boolean	trySetComputing()	尝试将future置为正在计算状态 只有成功将future从pending状态更新为computing状态时返回true
final TaskStatus	trySetComputing2()	尝试将future置为正在计算状态 该接口有更好的返回值，不过一般情况下还是推荐IPromise.trySetComputing()
final boolean	trySetException(Throwable cause)	尝试将future置为失败完成状态，如果future已进入完成状态，则返回false
final boolean	trySetResult(T result)	尝试将future置为成功完成状态，如果future已进入完成状态，则返回false
final boolean	tryTransferFrom(IFuture<? extends T> input)	将目标future的结果传输到当前Promise 如果目标future已完成，且当前promise尚未完成，则尝试传输结果到promise
Promise<T>	whenComplete(cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action)
Promise<T>	whenComplete(cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action, IContext ctx, int options)	该方法返回一个新的Future，无论当前Future执行成功还是失败，给定的操作都将执行，且返回的Future始终以相同的结果进入完成状态。
Promise<T>	whenCompleteAsync(Executor executor, cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action)
Promise<T>	whenCompleteAsync(Executor executor, cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action, IContext ctx, int options)

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

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

从接口继承的方法 cn.wjybxx.concurrent.ICompletionStage

toCompletableFuture

构造器详细资料

Promise

public Promise()

Promise

public Promise(Executor executor)

方法详细资料

completedPromise

public static <V> Promise<V> completedPromise(V result)

completedPromise

public static <V> Promise<V> completedPromise(V result,
 Executor executor)

failedPromise

public static <V> Promise<V> failedPromise(Throwable cause)

failedPromise

public static <V> Promise<V> failedPromise(Throwable cause,
 Executor executor)

executor

@Nullable
public Executor executor()

允许重写

指定者:

executor 在接口中 ICompletionStage<T>

asReadonly

public IFuture<T> asReadonly()

从接口复制的说明: IFuture

返回只读的Future视图， 如果Future是一个提供了写接口的Promise，则返回一个只读的Future视图，返回的实例会在当前Promise进入完成状态时进入完成状态。

1. 一般情况下我们通过接口隔离即可达到读写分离目的，这可以节省开销；在大规模链式调用的情况下，Promise继承Future很有效。 2. 但如果觉得返回Promise实例给任务的发起者不够安全，可创建Promise的只读视图返回给用户 3. 这里不要求返回的必须是同一个实例，每次都可以创建一个新的实例。

指定者:

asReadonly 在接口中 IFuture<T>

toFuture

@Nonnull
public IFuture<T> toFuture()

从接口复制的说明: ICompletionStage

返回一个Future，保持与这个Stage相同的完成结果。 如果这个Stage已经是一个Future，这个方法可以返回这个Stage本身。 可以返回Readonly的Future。

指定者:

toFuture 在接口中 ICompletionStage<T>

state

@Deprecated
public final Future.State state()

已过时。

指定者:

state 在接口中 Future<T>

指定者:

state 在接口中 IFuture<T>

status

public final TaskStatus status()

从接口复制的说明: IFuture

future关联的任务的状态

指定者:

status 在接口中 IFuture<T>

isPending

public final boolean isPending()

从接口复制的说明: IFuture

如果future关联的任务仍处于等待执行的状态，则返回true （换句话说，如果任务仍在排队，则返回true）

指定者:

isPending 在接口中 IFuture<T>

isComputing

public final boolean isComputing()

从接口复制的说明: IFuture

如果future关联的任务正在执行中，则返回true

指定者:

isComputing 在接口中 IFuture<T>

isSucceeded

public boolean isSucceeded()

从接口复制的说明: IFuture

如果future已进入完成状态，且是成功完成，则返回true。

指定者:

isSucceeded 在接口中 IFuture<T>

isFailed

public final boolean isFailed()

从接口复制的说明: IFuture

如果future已进入完成状态，且是失败状态，则返回true

指定者:

isFailed 在接口中 IFuture<T>

isCancelled

public final boolean isCancelled()

从接口复制的说明: IFuture

如果future关联的任务在正常完成被取消，则返回true。

指定者:

isCancelled 在接口中 Future<T>

指定者:

isCancelled 在接口中 IFuture<T>

isDone

public final boolean isDone()

从接口复制的说明: IFuture

如果future已进入完成状态(成功、失败、被取消)，则返回true

指定者:

isDone 在接口中 Future<T>

指定者:

isDone 在接口中 IFuture<T>

isFailedOrCancelled

public final boolean isFailedOrCancelled()

从接口复制的说明: IFuture

在JDK的约定中，取消和failed是分离的，我们仍保持这样的约定； 但有些时候，我们需要将取消也视为失败的一种，因此需要快捷的方法。

指定者:

isFailedOrCancelled 在接口中 IFuture<T>

trySetComputing

public final boolean trySetComputing()

从接口复制的说明: IPromise

尝试将future置为正在计算状态 只有成功将future从pending状态更新为computing状态时返回true

指定者:

trySetComputing 在接口中 IPromise<T>

trySetComputing2

public final TaskStatus trySetComputing2()

从接口复制的说明: IPromise

尝试将future置为正在计算状态 该接口有更好的返回值，不过一般情况下还是推荐IPromise.trySetComputing()

指定者:

trySetComputing2 在接口中 IPromise<T>

返回:

之前的状态

setComputing

public final void setComputing()

从接口复制的说明: IPromise

将future置为计算中状态，如果future之前不处于pending状态，则抛出IllegalStateException

指定者:

setComputing 在接口中 IPromise<T>

trySetResult

public final boolean trySetResult(T result)

从接口复制的说明: IPromise

尝试将future置为成功完成状态，如果future已进入完成状态，则返回false

指定者:

trySetResult 在接口中 IPromise<T>

setResult

public final void setResult(T result)

从接口复制的说明: IPromise

将future置为成功完成状态，如果future已进入完成状态，则抛出IllegalStateException

指定者:

setResult 在接口中 IPromise<T>

trySetException

public final boolean trySetException(@Nonnull
 Throwable cause)

从接口复制的说明: IPromise

尝试将future置为失败完成状态，如果future已进入完成状态，则返回false

指定者:

trySetException 在接口中 IPromise<T>

参数:

cause - 如果为CancellationException，则等同于取消

setException

public final void setException(@Nonnull
 Throwable cause)

从接口复制的说明: IPromise

将future置为失败状态，如果future已进入完成状态，则抛出IllegalStateException

指定者:

setException 在接口中 IPromise<T>

参数:

cause - 如果为CancellationException，则等同于取消

trySetCancelled

public boolean trySetCancelled(int code)

从接口复制的说明: IPromise

将Future置为已取消状态，如果future已进入完成状态，则返回false

指定者:

trySetCancelled 在接口中 IPromise<T>

参数:

code - 相关的取消码

setCancelled

public void setCancelled(int code)

从接口复制的说明: IPromise

将Future置为已取消状态，如果future已进入完成状态，则抛出IllegalStateException

指定者:

setCancelled 在接口中 IPromise<T>

参数:

code - 相关的取消码

cancel

@Deprecated
public final boolean cancel(boolean mayInterruptIfRunning)

已过时。

从接口复制的说明: IFuture

指定者:

cancel 在接口中 Future<T>

指定者:

cancel 在接口中 IFuture<T>

参数:

mayInterruptIfRunning - 在链式调用下没有意义

tryTransferFrom

public final boolean tryTransferFrom(IFuture<? extends T> input)

从接口复制的说明: IPromise

将目标future的结果传输到当前Promise 如果目标future已完成，且当前promise尚未完成，则尝试传输结果到promise

指定者:

tryTransferFrom 在接口中 IPromise<T>

返回:

当且仅当由目标future使当前promise进入完成状态时返回true。

getNow

public final T getNow()

从接口复制的说明: IFuture

获取关联的计算结果 -- 非阻塞。 如果对应的计算失败，则抛出对应的异常。 如果计算成功，则返回计算结果。 如果计算尚未完成，则返回null。

如果future关联的task没有返回值(操作完成返回null)，对于这种情况，你可以使用IFuture.isSucceeded()作为判断任务是否成功执行的更好选择。

指定者:

getNow 在接口中 IFuture<T>

getNow

public final T getNow(T valueIfAbsent)

从接口复制的说明: IFuture

尝试获取计算结果 -- 非阻塞 如果对应的计算失败，则抛出对应的异常。 如果计算成功，则返回计算结果。 如果计算尚未完成，则返回给定值。

指定者:

getNow 在接口中 IFuture<T>

参数:

valueIfAbsent - 计算尚未完成时的返回值

resultNow

public final T resultNow()

从接口复制的说明: IFuture

非阻塞方式获取Future的执行结果

指定者:

resultNow 在接口中 Future<T>

指定者:

resultNow 在接口中 IFuture<T>

exceptionNow

public final Throwable exceptionNow()

从接口复制的说明: IFuture

非阻塞方式获取导致Future失败的原因，不适用被取消的Future； 如果需要获取取消异常，可使用IFuture.exceptionNow(boolean)。

指定者:

exceptionNow 在接口中 Future<T>

指定者:

exceptionNow 在接口中 IFuture<T>

exceptionNow

public final Throwable exceptionNow(boolean throwIfCancelled)

从接口复制的说明: IFuture

获取导致任务失败的异常，可获取取消异常

指定者:

exceptionNow 在接口中 IFuture<T>

参数:

throwIfCancelled - 任务取消的状态下是否抛出状态异常

checkDeadlock

protected final void checkDeadlock()

死锁检查

get

public final T get()
            throws InterruptedException,
ExecutionException

从接口复制的说明: IFuture

指定者:

get 在接口中 Future<T>

指定者:

get 在接口中 IFuture<T>

抛出:

InterruptedException

ExecutionException

get

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

从接口复制的说明: IFuture

指定者:

get 在接口中 Future<T>

指定者:

get 在接口中 IFuture<T>

抛出:

InterruptedException

ExecutionException

TimeoutException

join

public final T join()
             throws CompletionException

从接口复制的说明: IFuture

阻塞到任务完成

指定者:

join 在接口中 IFuture<T>

抛出:

CompletionException - 计算失败

await

public final Promise<T> await()
                       throws InterruptedException

从接口复制的说明: IFuture

阻塞到任务完成

指定者:

await 在接口中 IFuture<T>

返回:

this

抛出:

InterruptedException

awaitUninterruptibly

public final Promise<T> awaitUninterruptibly()

从接口复制的说明: IFuture

阻塞到任务完成

指定者:

awaitUninterruptibly 在接口中 IFuture<T>

返回:

this

await

public final boolean await(long timeout,
 @Nonnull
 TimeUnit unit)
                    throws InterruptedException

指定者:

await 在接口中 IFuture<T>

返回:

如果任务在这期间进入了完成状态，则返回true

抛出:

InterruptedException

awaitUninterruptibly

public final boolean awaitUninterruptibly(long timeout,
 @Nonnull
 TimeUnit unit)

指定者:

awaitUninterruptibly 在接口中 IFuture<T>

返回:

如果任务在这期间进入了完成状态，则返回true

newIncompletePromise

protected <U> Promise<U> newIncompletePromise(Executor exe)

inheritContext

protected IContext inheritContext(int options)

composeApply

public <U> Promise<U> composeApply(BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法表示在当前Future与返回的Future中插入一个异步操作，构建异步管道 => 这是链式调用的核心API。 该方法对应我们日常流中使用的Stream.flatMap(Function)操作。

该方法返回一个新的Future，它的最终结果与指定的Function返回的Future结果相同。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则当前Future的执行结果将作为指定操作的执行参数。

CompletionStage.thenCompose(Function)

指定者:

composeApply 在接口中 ICompletionStage<T>

指定者:

composeApply 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

composeApply

public <U> Promise<U> composeApply(BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn)

指定者:

composeApply 在接口中 ICompletionStage<T>

指定者:

composeApply 在接口中 IFuture<T>

参数:

fn - 的ctx参数为IContext.NONE

composeApplyAsync

public <U> Promise<U> composeApplyAsync(Executor executor,
 BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn)

指定者:

composeApplyAsync 在接口中 ICompletionStage<T>

指定者:

composeApplyAsync 在接口中 IFuture<T>

composeApplyAsync

public <U> Promise<U> composeApplyAsync(Executor executor,
 BiFunction<? super IContext,? super T,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

composeApplyAsync 在接口中 ICompletionStage<T>

指定者:

composeApplyAsync 在接口中 IFuture<T>

composeCall

public <U> Promise<U> composeCall(Function<? super IContext,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法表示在当前Future与返回的Future中插入一个异步操作，构建异步管道 该方法对应我们日常流中使用的Stream.flatMap(Function)操作。

该方法返回一个新的Future，它的最终结果与指定的Function返回的Future结果相同。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则当前Future的执行结果将作为指定操作的执行参数。

CompletionStage.thenCompose(Function) ICompletionStage.composeApply(BiFunction)

指定者:

composeCall 在接口中 ICompletionStage<T>

指定者:

composeCall 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

composeCall

public <U> Promise<U> composeCall(Function<? super IContext,? extends ICompletionStage<U>> fn)

指定者:

composeCall 在接口中 ICompletionStage<T>

指定者:

composeCall 在接口中 IFuture<T>

composeCallAsync

public <U> Promise<U> composeCallAsync(Executor executor,
 Function<? super IContext,? extends ICompletionStage<U>> fn)

指定者:

composeCallAsync 在接口中 ICompletionStage<T>

指定者:

composeCallAsync 在接口中 IFuture<T>

composeCallAsync

public <U> Promise<U> composeCallAsync(Executor executor,
 Function<? super IContext,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

composeCallAsync 在接口中 ICompletionStage<T>

指定者:

composeCallAsync 在接口中 IFuture<T>

composeCatching

public <X extends Throwable> Promise<T> composeCatching(Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

它表示能从从特定的异常中恢复，并异步返回一个正常结果。

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future正常完成，则给定的动作不会执行，且返回的Future使用相同的结果值进入完成状态。 如果当前Future执行失败，则其异常信息将作为指定操作的执行参数，返回的Future的结果取决于指定操作的执行结果。

指定者:

composeCatching 在接口中 ICompletionStage<T>

指定者:

composeCatching 在接口中 IFuture<T>

参数:

fallback - 恢复函数

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

composeCatching

public <X extends Throwable> Promise<T> composeCatching(Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback)

指定者:

composeCatching 在接口中 ICompletionStage<T>

指定者:

composeCatching 在接口中 IFuture<T>

composeCatchingAsync

public <X extends Throwable> Promise<T> composeCatchingAsync(Executor executor,
 Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback)

指定者:

composeCatchingAsync 在接口中 ICompletionStage<T>

指定者:

composeCatchingAsync 在接口中 IFuture<T>

composeCatchingAsync

public <X extends Throwable> Promise<T> composeCatchingAsync(Executor executor,
 Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends ICompletionStage<T>> fallback,
 @Nullable
 IContext ctx,
 int options)

指定者:

composeCatchingAsync 在接口中 ICompletionStage<T>

指定者:

composeCatchingAsync 在接口中 IFuture<T>

composeHandle

public <U> Promise<U> composeHandle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

它表示既能接收任务的正常结果，也可以接收任务异常结果，并异步返回一个运算结果。

该方法返回一个新的Future，它的结果由当前Future驱动。 不论当前Future成功还是失败，都将执行给定的操作，返回的Future的结果取决于指定操作的执行结果。

指定者:

composeHandle 在接口中 ICompletionStage<T>

指定者:

composeHandle 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

composeHandle

public <U> Promise<U> composeHandle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn)

指定者:

composeHandle 在接口中 ICompletionStage<T>

指定者:

composeHandle 在接口中 IFuture<T>

composeHandleAsync

public <U> Promise<U> composeHandleAsync(Executor executor,
 cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn)

指定者:

composeHandleAsync 在接口中 ICompletionStage<T>

指定者:

composeHandleAsync 在接口中 IFuture<T>

composeHandleAsync

public <U> Promise<U> composeHandleAsync(Executor executor,
 cn.wjybxx.base.function.TriFunction<? super IContext,? super T,? super Throwable,? extends ICompletionStage<U>> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

composeHandleAsync 在接口中 ICompletionStage<T>

指定者:

composeHandleAsync 在接口中 IFuture<T>

thenApply

public <U> Promise<U> thenApply(BiFunction<? super IContext,? super T,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则当前Future的执行结果将作为指定操作的执行参数，返回的Future的结果取决于指定操作的执行结果。

CompletionStage.thenApply(Function)

指定者:

thenApply 在接口中 ICompletionStage<T>

指定者:

thenApply 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

thenApply

public <U> Promise<U> thenApply(BiFunction<? super IContext,? super T,? extends U> fn)

指定者:

thenApply 在接口中 ICompletionStage<T>

指定者:

thenApply 在接口中 IFuture<T>

thenApplyAsync

public <U> Promise<U> thenApplyAsync(Executor executor,
 BiFunction<? super IContext,? super T,? extends U> fn)

指定者:

thenApplyAsync 在接口中 ICompletionStage<T>

指定者:

thenApplyAsync 在接口中 IFuture<T>

thenApplyAsync

public <U> Promise<U> thenApplyAsync(Executor executor,
 BiFunction<? super IContext,? super T,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

thenApplyAsync 在接口中 ICompletionStage<T>

指定者:

thenApplyAsync 在接口中 IFuture<T>

thenAccept

public Promise<Void> thenAccept(BiConsumer<? super IContext,? super T> action,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则当前Future的执行结果将作为指定操作的执行参数，返回的Future的结果取决于指定操作的执行结果。

CompletionStage.thenAccept(Consumer)

指定者:

thenAccept 在接口中 ICompletionStage<T>

指定者:

thenAccept 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

thenAccept

public Promise<Void> thenAccept(BiConsumer<? super IContext,? super T> action)

指定者:

thenAccept 在接口中 ICompletionStage<T>

指定者:

thenAccept 在接口中 IFuture<T>

thenAcceptAsync

public Promise<Void> thenAcceptAsync(Executor executor,
 BiConsumer<? super IContext,? super T> action)

指定者:

thenAcceptAsync 在接口中 ICompletionStage<T>

指定者:

thenAcceptAsync 在接口中 IFuture<T>

thenAcceptAsync

public Promise<Void> thenAcceptAsync(Executor executor,
 BiConsumer<? super IContext,? super T> action,
 @Nullable
 IContext ctx,
 int options)

指定者:

thenAcceptAsync 在接口中 ICompletionStage<T>

指定者:

thenAcceptAsync 在接口中 IFuture<T>

thenCall

public <U> Promise<U> thenCall(Function<? super IContext,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则执行给定的操作，返回的Future的结果取决于指定操作的执行结果。

指定者:

thenCall 在接口中 ICompletionStage<T>

指定者:

thenCall 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

thenCall

public <U> Promise<U> thenCall(Function<? super IContext,? extends U> fn)

指定者:

thenCall 在接口中 ICompletionStage<T>

指定者:

thenCall 在接口中 IFuture<T>

thenCallAsync

public <U> Promise<U> thenCallAsync(Executor executor,
 Function<? super IContext,? extends U> fn)

指定者:

thenCallAsync 在接口中 ICompletionStage<T>

指定者:

thenCallAsync 在接口中 IFuture<T>

thenCallAsync

public <U> Promise<U> thenCallAsync(Executor executor,
 Function<? super IContext,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

thenCallAsync 在接口中 ICompletionStage<T>

指定者:

thenCallAsync 在接口中 IFuture<T>

thenRun

public Promise<Void> thenRun(Consumer<? super IContext> action,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future执行失败，则返回的Future将以相同的原因失败，且指定的动作不会执行。 如果当前Future执行成功，则执行给定的操作，返回的Future的结果取决于指定操作的执行结果。

CompletionStage.thenRun(Runnable)

指定者:

thenRun 在接口中 ICompletionStage<T>

指定者:

thenRun 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

thenRun

public Promise<Void> thenRun(Consumer<? super IContext> action)

指定者:

thenRun 在接口中 ICompletionStage<T>

指定者:

thenRun 在接口中 IFuture<T>

thenRunAsync

public Promise<Void> thenRunAsync(Executor executor,
 Consumer<? super IContext> action)

指定者:

thenRunAsync 在接口中 ICompletionStage<T>

指定者:

thenRunAsync 在接口中 IFuture<T>

thenRunAsync

public Promise<Void> thenRunAsync(Executor executor,
 Consumer<? super IContext> action,
 @Nullable
 IContext ctx,
 int options)

指定者:

thenRunAsync 在接口中 ICompletionStage<T>

指定者:

thenRunAsync 在接口中 IFuture<T>

catching

public <X extends Throwable> Promise<T> catching(Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends T> fallback,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

它表示能从从特定的异常中恢复，并返回一个正常结果。

该方法返回一个新的Future，它的结果由当前Future驱动。 如果当前Future正常完成，则给定的动作不会执行，且返回的Future使用相同的结果值进入完成状态。 如果当前Future执行失败，则其异常信息将作为指定操作的执行参数，返回的Future的结果取决于指定操作的执行结果。

不得不说JDK的CompletionStage.exceptionally(Function)这个名字太差劲了，实现的也不够好，因此我们不使用它， 这里选择了Guava中的实现

指定者:

catching 在接口中 ICompletionStage<T>

指定者:

catching 在接口中 IFuture<T>

参数:

exceptionType - 能处理的异常类型

fallback - 异常恢复函数

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

catching

public <X extends Throwable> Promise<T> catching(Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends T> fallback)

指定者:

catching 在接口中 ICompletionStage<T>

指定者:

catching 在接口中 IFuture<T>

catchingAsync

public <X extends Throwable> Promise<T> catchingAsync(Executor executor,
 Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends T> fallback)

指定者:

catchingAsync 在接口中 ICompletionStage<T>

指定者:

catchingAsync 在接口中 IFuture<T>

catchingAsync

public <X extends Throwable> Promise<T> catchingAsync(Executor executor,
 Class<X> exceptionType,
 BiFunction<? super IContext,? super X,? extends T> fallback,
 @Nullable
 IContext ctx,
 int options)

指定者:

catchingAsync 在接口中 ICompletionStage<T>

指定者:

catchingAsync 在接口中 IFuture<T>

handle

public <U> Promise<U> handle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法表示既能处理当前计算的正常结果，又能处理当前结算的异常结果(可以将异常转换为新的结果)，并返回一个新的结果。

该方法返回一个新的Future，无论当前Future执行成功还是失败，给定的操作都将执行。 如果当前Future执行成功，而指定的动作出现异常，则返回的Future以该异常完成。 如果当前Future执行失败，且指定的动作出现异常，则返回的Future以新抛出的异常进入完成状态。

CompletionStage.handle(BiFunction)

指定者:

handle 在接口中 ICompletionStage<T>

指定者:

handle 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

handle

public <U> Promise<U> handle(cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn)

指定者:

handle 在接口中 ICompletionStage<T>

指定者:

handle 在接口中 IFuture<T>

handleAsync

public <U> Promise<U> handleAsync(Executor executor,
 cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn)

指定者:

handleAsync 在接口中 ICompletionStage<T>

指定者:

handleAsync 在接口中 IFuture<T>

handleAsync

public <U> Promise<U> handleAsync(Executor executor,
 cn.wjybxx.base.function.TriFunction<? super IContext,? super T,Throwable,? extends U> fn,
 @Nullable
 IContext ctx,
 int options)

指定者:

handleAsync 在接口中 ICompletionStage<T>

指定者:

handleAsync 在接口中 IFuture<T>

whenComplete

public Promise<T> whenComplete(cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action,
 @Nullable
 IContext ctx,
 int options)

从接口复制的说明: ICompletionStage

该方法返回一个新的Future，无论当前Future执行成功还是失败，给定的操作都将执行，且返回的Future始终以相同的结果进入完成状态。 与方法ICompletionStage.handle(TriFunction)不同，此方法不是为转换完成结果而设计的，因此提供的操作不应引发异常。
1.如果action出现了异常，则仅仅记录一个日志，不向下传播(这里与JDK实现不同) -- 应当避免抛出异常。 2.如果用户主动取消了返回的Future，或者用于异步执行的Executor已关闭，则不会以相同的结果进入完成状态。

指定者:

whenComplete 在接口中 ICompletionStage<T>

指定者:

whenComplete 在接口中 IFuture<T>

参数:

ctx - 上下文，如果为null，则替换为NONE

options - 调度选项，默认使用0即可，可参考TaskOption

whenComplete

public Promise<T> whenComplete(cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action)

指定者:

whenComplete 在接口中 ICompletionStage<T>

指定者:

whenComplete 在接口中 IFuture<T>

whenCompleteAsync

public Promise<T> whenCompleteAsync(Executor executor,
 cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action)

指定者:

whenCompleteAsync 在接口中 ICompletionStage<T>

指定者:

whenCompleteAsync 在接口中 IFuture<T>

whenCompleteAsync

public Promise<T> whenCompleteAsync(Executor executor,
 cn.wjybxx.base.function.TriConsumer<? super IContext,? super T,? super Throwable> action,
 @Nullable
 IContext ctx,
 int options)

指定者:

whenCompleteAsync 在接口中 ICompletionStage<T>

指定者:

whenCompleteAsync 在接口中 IFuture<T>

onCompleted

public void onCompleted(Consumer<? super IFuture<T>> action,
 int options)

从接口复制的说明: IFuture

最原始的Future监听接口 1. 给定的Action将在Future关联的任务完成时执行，无论成功或失败都将执行。 2. 该操作不是链式调用，不会继承上下文！不会继承上下文！不会继承上下文！ 3. 通常只用于一些特殊功能 -- 比如大规模监听时减少开销。 4. 暂不设定返回会为this，以免以后需要封装用于删除的句柄等

指定者:

onCompleted 在接口中 IFuture<T>

参数:

options - 调度选项，可为0

onCompleted

public void onCompleted(Consumer<? super IFuture<T>> action)

指定者:

onCompleted 在接口中 IFuture<T>

onCompletedAsync

public void onCompletedAsync(Executor executor,
 Consumer<? super IFuture<T>> action)

指定者:

onCompletedAsync 在接口中 IFuture<T>

onCompletedAsync

public void onCompletedAsync(Executor executor,
 Consumer<? super IFuture<T>> action,
 int options)

指定者:

onCompletedAsync 在接口中 IFuture<T>

onCompleted

public void onCompleted(BiConsumer<? super IFuture<T>,? super IContext> action,
 @Nonnull
 IContext context,
 int options)

从接口复制的说明: IFuture

该接口支持Context参数，可响应取消

指定者:

onCompleted 在接口中 IFuture<T>

onCompleted

public void onCompleted(BiConsumer<? super IFuture<T>,? super IContext> action,
 @Nonnull
 IContext context)

指定者:

onCompleted 在接口中 IFuture<T>

onCompletedAsync

public void onCompletedAsync(Executor executor,
 BiConsumer<? super IFuture<T>,? super IContext> action,
 @Nonnull
 IContext context)

指定者:

onCompletedAsync 在接口中 IFuture<T>

onCompletedAsync

public void onCompletedAsync(Executor executor,
 BiConsumer<? super IFuture<T>,? super IContext> action,
 @Nonnull
 IContext context,
 int options)

指定者:

onCompletedAsync 在接口中 IFuture<T>