cn.yerl.android.promise.core

类 Promise<R>

java.lang.Object

cn.yerl.android.promise.core.Promise<R>

类型参数:

R - 返回值类型

public class Promise<R>
extends java.lang.Object

Android Promise

从以下版本开始:

16/3/17

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	Promise.State

构造器概要

构造器

构造器和说明
Promise() 创建一个空的Promise
Promise(long delayMillis, PromiseCallback<T,R> callback) 创建延迟执行的Promise
Promise(long delayMillis, PromiseCallbackWithResolver<T,R> resolver) 创建延迟执行的Promise,使用Resolver回调
Promise(PromiseCallback<T,R> callback) 主线程执行的Promise
Promise(PromiseCallbackWithResolver<T,R> resolver) 创建一个未执行的Promise
Promise(java.lang.RuntimeException error) 获取一个Rejected状态的Promise

方法概要

限定符和类型	方法和说明
static <T,V> Promise<java.util.List<V>>	all(java.util.List<Promise<V>> promises) 包装一系列的Promise对象,返回一个包装后的Promise对象,称之为A 1.
<V> Promise<V>	always(PromiseCallback<java.lang.Object,V> always) 主线程执行,正确或失败都会执行
<V> Promise<V>	alwaysAsync(PromiseCallback<java.lang.Object,V> always) 异步执行,正确或失败都会执行
<V> Promise<V>	error(PromiseCallback<java.lang.RuntimeException,V> error) 同步处理错误
<V> Promise<V>	errorAsync(PromiseCallback<java.lang.RuntimeException,V> error) 异步处理错误
Promise.State	getState() Promise 当前状态
java.lang.Object	getValue() Promise最终结果
static <T,V> Promise<V>	race(java.util.List<Promise<V>> promises) 包装一列列的Promise对象,返回一个包装后的Promise对象,称之为R 1.
static <V> Promise<V>	resolve(Promise<V> promise) 直接返回promise
static <T,V> Promise<V>	resolve(java.lang.RuntimeException ex) 返回一个Rejected状态的Promise
static <T,V> Promise<V>	resolve(T result) 返回一个Fulfilled状态的Promise
<V> Promise<V>	then(Promise<V> thenPromise) 附加Promise
<V> Promise<V>	then(PromiseCallback<R,V> then) 主线程执行
<V> Promise<V>	then(PromiseCallbackWithResolver<R,V> then) 主线程执行,使用 Resolver来回调
<V> Promise<V>	thenAsync(PromiseCallback<R,V> then) 异步执行
<V> Promise<V>	thenAsync(PromiseCallbackWithResolver<R,V> then) 异步执行,使用Resolver来回调
<V> Promise<V>	thenDelay(long delayMillis, PromiseCallback<R,V> then) 延迟执行
<V> Promise<V>	thenDelay(long delayMillis, PromiseCallbackWithResolver<R,V> then) 延迟执行,使用Resolver回调

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

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

构造器详细资料

Promise

public Promise()

创建一个空的Promise

Promise

public Promise(PromiseCallbackWithResolver<T,R> resolver)

创建一个未执行的Promise

类型参数:

T - 返回值类型

参数:

resolver - Promise Resolver

Promise

public Promise(long delayMillis,
               PromiseCallbackWithResolver<T,R> resolver)

创建延迟执行的Promise,使用Resolver回调

类型参数:

T - 返回值类型

参数:

delayMillis - 延迟时间，毫秒

resolver - PromiseCallbackWithResolver

Promise

public Promise(long delayMillis,
               PromiseCallback<T,R> callback)

创建延迟执行的Promise

类型参数:

T - 返回值类型

参数:

delayMillis - 延迟时间，毫秒

callback - PromiseCallback

Promise

public Promise(PromiseCallback<T,R> callback)

主线程执行的Promise

类型参数:

T - 返回值类型

参数:

callback - PromiseCallback

Promise

public Promise(java.lang.RuntimeException error)

获取一个Rejected状态的Promise

类型参数:

T - 返回值类型

参数:

error - 错误

方法详细资料

getState

public Promise.State getState()

Promise 当前状态

返回:

State

getValue

public java.lang.Object getValue()

Promise最终结果

返回:

Object

resolve

public static <V> Promise<V> resolve(Promise<V> promise)

直接返回promise

类型参数:

V - 返回值类型

参数:

promise - Promise

返回:

Promise

resolve

public static <T,V> Promise<V> resolve(T result)

返回一个Fulfilled状态的Promise

类型参数:

T - 参数类型

V - 返回值类型

参数:

result - 结果

返回:

Promise

resolve

public static <T,V> Promise<V> resolve(java.lang.RuntimeException ex)

返回一个Rejected状态的Promise

类型参数:

T - 参数类型

V - 返回值类型

参数:

ex - 错误

返回:

Promise

all

public static <T,V> Promise<java.util.List<V>> all(java.util.List<Promise<V>> promises)

包装一系列的Promise对象,返回一个包装后的Promise对象,称之为A 1. 当所有的Promise对象都变成成功态(Fulfilled)后,这个包装后的A才会把自己变成成功状态. A会等最慢的那个Promise对象变成成功态(Fulfilled)后才把自己变成成功态. 2. 只要其中一个Promise对象变成失败态(Rejected),包装后的A就会变成Rejected,并且每一个Rejected传递的值, 会传递给A后面的catch

类型参数:

T - 参数类型

V - 返回值类型

参数:

promises - List of promise

返回:

Promise

race

public static <T,V> Promise<V> race(java.util.List<Promise<V>> promises)

包装一列列的Promise对象,返回一个包装后的Promise对象,称之为R 1. 只要其中的一个Promise对象变成成功态(Fulfilled)后,这个包装后的R就会变成成功态(Fulfilled). 2. 当所有的promise对象都变成失败态(Rejected)后,这个包装后的R才会变成失败态.

类型参数:

T - 参数类型

V - 返回值类型

参数:

promises - List of promise

返回:

Promise

then

public <V> Promise<V> then(PromiseCallback<R,V> then)

主线程执行

类型参数:

V - 返回值类型

参数:

then - next step

返回:

Promise

then

public <V> Promise<V> then(Promise<V> thenPromise)

附加Promise

类型参数:

V - 返回值类型

参数:

thenPromise - next step

返回:

Promise

then

public <V> Promise<V> then(PromiseCallbackWithResolver<R,V> then)

主线程执行,使用 Resolver来回调

类型参数:

V - 返回值类型

参数:

then - next step

返回:

Promise

thenAsync

public <V> Promise<V> thenAsync(PromiseCallback<R,V> then)

异步执行

类型参数:

V - 返回值类型

参数:

then - next step

返回:

Promise

thenAsync

public <V> Promise<V> thenAsync(PromiseCallbackWithResolver<R,V> then)

异步执行,使用Resolver来回调

类型参数:

V - 返回值类型

参数:

then - next step

返回:

Promise

thenDelay

public <V> Promise<V> thenDelay(long delayMillis,
                                PromiseCallback<R,V> then)

延迟执行

类型参数:

V - 返回值类型

参数:

delayMillis - 延迟时间，毫秒

then - 下一步

返回:

Promise

thenDelay

public <V> Promise<V> thenDelay(long delayMillis,
                                PromiseCallbackWithResolver<R,V> then)

延迟执行,使用Resolver回调

类型参数:

V - 返回值类型

参数:

delayMillis - delay time

then - next step

返回:

Promise

error

public <V> Promise<V> error(PromiseCallback<java.lang.RuntimeException,V> error)

同步处理错误

类型参数:

V - 返回值类型

参数:

error - handle error

返回:

Promise

errorAsync

public <V> Promise<V> errorAsync(PromiseCallback<java.lang.RuntimeException,V> error)

异步处理错误

类型参数:

V - 返回值类型

参数:

error - handle error

返回:

Promise

always

public <V> Promise<V> always(PromiseCallback<java.lang.Object,V> always)

主线程执行,正确或失败都会执行

类型参数:

V - 返回值类型

参数:

always - handle always

返回:

Promise

alwaysAsync

public <V> Promise<V> alwaysAsync(PromiseCallback<java.lang.Object,V> always)

异步执行,正确或失败都会执行

类型参数:

V - 返回值类型

参数:

always - handle always

返回:

Promise