net.lulihu.promise

类 Promise<V>

java.lang.Object

net.lulihu.promise.Promise<V>

类型参数:

V -

所有已实现的接口:

Future<V>

public class Promise<V>
extends Object
implements Future<V>

誓言

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	Promise.Action<T> 事件

字段概要

字段

限定符和类型	字段和说明
protected Throwable	exception

构造器概要

构造器

构造器和说明
Promise()

方法概要

限定符和类型	方法和说明
<R> Promise<R>	bind(java.util.function.Function<V,Promise<R>> function) 在原有的誓言流程上继续绑定誓言
boolean	cancel(boolean mayInterruptIfRunning)
static <T,R> java.util.function.Function<Promise<T>,Promise<R>>	fmap(java.util.function.Function<T,R> function) 使用方式 Promise apply = Promise.fmap((Function) i -> i + "-").apply(Promise.pure(10));
V	get() 获取处理结果 该方法会阻塞直到产生结果值或者被中断抛出例外
V	get(long timeout, TimeUnit unit) 在指定时间内获取处理结果 该方法会阻塞指定长度的时间，如果在指定时间内返回处理结果则返回，如果没有返回结果则抛出超时例外
V	getOrNull() 获取结果 该方法立即返回，如果还未产生结果至则返回null
boolean	isCancelled()
boolean	isDone()
static <T> Promise<T>	join(Promise<Promise<T>> promise) 加入多个方式
static <T> java.util.function.Function<T,Promise<Void>>	lift(java.util.function.Consumer<T> consumer) 使用方式 Promise.lift((Consumer
static <T,R> java.util.function.Function<T,Promise<R>>	lift(java.util.function.Function<T,R> function) 使用方式 Promise promise = Promise.lift((Function) i -> i++).apply(10);
void	onRedeem(Promise.Action<Promise<V>> callback) 增加承诺 如果当前承诺正在实现过程中则直接执行否则添加到回调
static <V> Promise<V>	pure(V v) 使用誓言对象
static <T> Promise<List<T>>	waitAll(Collection<Promise<T>> promises) 等待所有承诺完成 在返回
static <T> Promise<List<T>>	waitAll(Promise<T>... promises) 等待所有承诺完成 再返回
static <V> Promise<V>	wrap(Throwable t) 使用誓言对象

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

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

字段详细资料

exception

protected Throwable exception

构造器详细资料

Promise

public Promise()

方法详细资料

cancel

public boolean cancel(boolean mayInterruptIfRunning)

指定者:

cancel 在接口中 Future<V>

isCancelled

public boolean isCancelled()

指定者:

isCancelled 在接口中 Future<V>

isDone

public boolean isDone()

指定者:

isDone 在接口中 Future<V>

getOrNull

public V getOrNull()

获取结果

该方法立即返回，如果还未产生结果至则返回null

返回:

返回处理结果或者null

get

public V get()
      throws InterruptedException,
             ExecutionException

获取处理结果

该方法会阻塞直到产生结果值或者被中断抛出例外

指定者:

get 在接口中 Future<V>

返回:

返回处理结果

抛出:

InterruptedException - 在处理过程中被中断抛出

ExecutionException - 执行过程中出现例外抛出

get

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

在指定时间内获取处理结果

该方法会阻塞指定长度的时间，如果在指定时间内返回处理结果则返回，如果没有返回结果则抛出超时例外

指定者:

get 在接口中 Future<V>

参数:

timeout - 时间

unit - 单位

返回:

处理结果

抛出:

InterruptedException - 在处理过程中被中断抛出

ExecutionException - 执行过程中出现例外抛出

TimeoutException - 指定时间内未能返回处理结果则抛出

onRedeem

public void onRedeem(Promise.Action<Promise<V>> callback)

增加承诺

如果当前承诺正在实现过程中则直接执行否则添加到回调

参数:

callback - 回调

waitAll

public static <T> Promise<List<T>> waitAll(Promise<T>... promises)

等待所有承诺完成 再返回

类型参数:

T - 泛型

参数:

promises - 承诺s

返回:

Promise

waitAll

public static <T> Promise<List<T>> waitAll(Collection<Promise<T>> promises)

等待所有承诺完成 在返回

类型参数:

T - 泛型

参数:

promises - 承诺s

返回:

Promise

pure

public static <V> Promise<V> pure(V v)

使用誓言对象

类型参数:

V - 入参类型

参数:

v - 参数

返回:

返回一个包装入参的誓言对象

wrap

public static <V> Promise<V> wrap(Throwable t)

使用誓言对象

类型参数:

V - v

参数:

t - 异常

返回:

返回一个包装指定异常的誓言对象

bind

public <R> Promise<R> bind(java.util.function.Function<V,Promise<R>> function)

在原有的誓言流程上继续绑定誓言

类型参数:

R - 绑定誓言的类型

参数:

function - 誓言转换函数

返回:

绑定后的誓言对象

fmap

public static <T,R> java.util.function.Function<Promise<T>,Promise<R>> fmap(java.util.function.Function<T,R> function)

使用方式

Promise apply = Promise.fmap((Function) i -> i + "-").apply(Promise.pure(10));

类型参数:

T - 入参

R - 出参

参数:

function - 处理表达式

返回:

Function

join

public static <T> Promise<T> join(Promise<Promise<T>> promise)

加入多个方式

类型参数:

T - 入参类型

参数:

promise - 誓言

返回:

Promise

lift

public static <T,R> java.util.function.Function<T,Promise<R>> lift(java.util.function.Function<T,R> function)

使用方式

Promise promise = Promise.lift((Function) i -> i++).apply(10);

类型参数:

T - 入参类型

R - 返回参数

参数:

function - 表达式

返回:

Function

lift

public static <T> java.util.function.Function<T,Promise<Void>> lift(java.util.function.Consumer<T> consumer)

使用方式

Promise.lift((Consumer