com.englishtown.promises

Class WhenProgress<TResolve,TProgress>

java.lang.Object

com.englishtown.promises.WhenProgress<TResolve,TProgress>

Type Parameters:

TResolve - the type passed to fulfillment or rejection handlers

TProgress - the type passed to progress handlers

Direct Known Subclasses:

When

public class WhenProgress<TResolve,TProgress>
extends Object

A Java implementation of the CommonJS Promises/A specification. http://wiki.commonjs.org/wiki/Promises/A

Based on the when.js 2.8.0 library (c) copyright B Cavalier & J Hann (https://github.com/cujojs/when)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	WhenProgress.FulfilledPromise Creates a fulfilled, local promise as a proxy for a value NOTE: must never be exposed
protected class	WhenProgress.ProgressingPromise Create a progress promise with the supplied update.
protected class	WhenProgress.Promise0
protected class	WhenProgress.RejectedPromise Creates a rejected, local promise as a proxy for a value NOTE: must never be exposed
protected class	WhenProgress.TrustedPromise

Constructor Summary

Constructors

Constructor and Description
WhenProgress()

Method Summary

Methods

Modifier and Type	Method and Description
ProgressPromise<List<? extends TResolve>,TProgress>	all(List<? extends ProgressPromise<TResolve,TProgress>> promises) Return a promise that will resolve only once all the supplied promises have resolved.
ProgressPromise<List<? extends TResolve>,TProgress>	allValues(List<TResolve> values) Return a resolved promise for the list of input values.
ProgressPromise<TResolve,TProgress>	any(List<? extends ProgressPromise<TResolve,TProgress>> promises) Initiates a competitive race, returning a promise that will resolve when any one of the supplied promises has resolved or will reject when *all* promises have rejected.
ProgressPromise<TResolve,TProgress>	anyValues(List<TResolve> values) Resolves immediately returning a resolved ProgressPromise with the first value from the input list.
ProgressPromise<TResolve,TProgress>	chain(ProgressPromise<TResolve,TProgress> promise, Resolver<TResolve,TProgress> resolver) Ensure that resolution of a promise will trigger the resolver with the resolved value.
ProgressPromise<TResolve,TProgress>	chain(ProgressPromise<TResolve,TProgress> promise, Resolver<TResolve,TProgress> resolver, TResolve resolveValue) Ensure that resolution of a promise will trigger the resolver with the provided resolveValue.
protected WhenProgress.FulfilledPromise	createFulfilledPromise(TResolve value)
protected WhenProgress.ProgressingPromise	createProgressingPromise(Value<TProgress> value)
protected WhenProgress.Promise0	createPromise0(ResolveCallback<TResolve,TProgress> resolver, PromiseStatus status)
protected WhenProgress.RejectedPromise	createRejectedPromise(Value<TResolve> value)
DeferredProgress<TResolve,TProgress>	defer() Creates a {promise, resolver} pair, either or both of which may be given out safely to consumers.
protected static MonitorApi	getMonitorApi()
ProgressPromise<List<? extends TResolve>,TProgress>	join(ProgressPromise<TResolve,TProgress>... promises) Joins multiple promises into a single returned promise.
ProgressPromise<List<? extends TResolve>,TProgress>	join(TResolve... values) Joins multiple promises into a single returned promise.
ProgressPromise<List<? extends TResolve>,TProgress>	map(List<? extends ProgressPromise<TResolve,TProgress>> promises, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> mapFunc) Promise-aware array map function, similar to `Array.prototype.map()`, but input array may contain promises or values.
ProgressPromise<List<? extends TResolve>,TProgress>	map(ProgressPromise<List<? extends TResolve>,TProgress> promise, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> mapFunc) Traditional map function, but the input is a ProgressPromise for values to be mapped.
<T> ProgressPromise<T,TProgress>	reduce(List<ProgressPromise<TResolve,TProgress>> promises, Reducer<T,TResolve> reduceFunc) Traditional reduce function, but the input is a list of ProgressPromises.
<T> ProgressPromise<T,TProgress>	reduce(List<ProgressPromise<TResolve,TProgress>> promises, Reducer<T,TResolve> reduceFunc, ProgressPromise<T,TProgress> initialValue) Traditional reduce function, but the input is a list of ProgressPromises.
<T> ProgressPromise<T,TProgress>	reduce(List<ProgressPromise<TResolve,TProgress>> promises, Reducer<T,TResolve> reduceFunc, T initialValue) Traditional reduce function, but the input is a list of ProgressPromises.
<T> ProgressPromise<T,TProgress>	reduce(ProgressPromise<List<TResolve>,TProgress> promise, Reducer<T,TResolve> reduceFunc, ProgressPromise<T,TProgress> initialValue) Traditional reduce function, but the input is a ProgressPromise for a list of values.
<T> ProgressPromise<T,TProgress>	reduce(ProgressPromise<List<TResolve>,TProgress> promise, Reducer<T,TResolve> reduceFunc, T initialValue) Traditional reduce function, but the input is a ProgressPromise for a list of values.
<T> ProgressPromise<T,TProgress>	reduceValues(List<TResolve> values, Reducer<T,TResolve> reduceFunc) Traditional reduce function, where the input is a list of values to reduce.
<T> ProgressPromise<T,TProgress>	reduceValues(List<TResolve> values, Reducer<T,TResolve> reduceFunc, ProgressPromise<T,TProgress> initialValue) Traditional reduce function, where the input is a list of values to reduce.
<T> ProgressPromise<T,TProgress>	reduceValues(List<TResolve> values, Reducer<T,TResolve> reduceFunc, T initialValue) Traditional reduce function, where the input is a list of values to reduce.
ProgressPromise<TResolve,TProgress>	reject(Thenable<TResolve,TProgress> x) Returns a rejected promise for the supplied promiseOrValue.
ProgressPromise<TResolve,TProgress>	reject(Throwable x) Returns a rejected promise for the supplied promiseOrValue.
ProgressPromise<TResolve,TProgress>	reject(TResolve x) Returns a rejected promise for the supplied promiseOrValue.
ProgressPromise<TResolve,TProgress>	reject(Value<TResolve> x) Returns a rejected promise for the supplied promiseOrValue.
ProgressPromise<TResolve,TProgress>	resolve(Thenable<TResolve,TProgress> x) Returns a resolved promise.
ProgressPromise<TResolve,TProgress>	resolve(TResolve x) Returns a resolved promise.
List<ProgressPromise<TResolve,TProgress>>	resolveValues(List<? extends TResolve> values) Converts a list of values to a list of resolved promises.
<TArg> ProgressPromise<List<TResolve>,TProgress>	sequence(List<Runnable<ProgressPromise<TResolve,TProgress>,TArg>> tasks, TArg arg) Run list of tasks in sequence with no overlap
ProgressPromise<List<TResolve>,TProgress>	sequence(List<Runnable<ProgressPromise<TResolve,TProgress>,Void>> tasks) Run list of tasks in sequence with no overlap
static void	setNextTick(Executor executor) Sets the executor to asynchronously run callbacks on an event loop.
ProgressPromise<List<? extends TResolve>,TProgress>	some(List<? extends ProgressPromise<TResolve,TProgress>> promises, int howMany) Initiates a competitive race, returning a promise that will resolve when howMany of the supplied promisesOrValues have resolved, or will reject when it becomes impossible for howMany to resolve, for example, when (promisesOrValues.length - howMany) + 1 input promises reject.
ProgressPromise<List<? extends TResolve>,TProgress>	someValues(List<TResolve> values, int howMany) Resolves immediately returning a resolved ProgressPromise with the specified number of values.
ProgressPromise<TResolve,TProgress>	when(Thenable<TResolve,TProgress> promise) Register an observer for a promise.
ProgressPromise<TResolve,TProgress>	when(Thenable<TResolve,TProgress> promise, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled) Register an observer for a promise.
ProgressPromise<TResolve,TProgress>	when(Thenable<TResolve,TProgress> promise, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled, Runnable<ProgressPromise<TResolve,TProgress>,Value<TResolve>> onRejected) Register an observer for a promise.
ProgressPromise<TResolve,TProgress>	when(Thenable<TResolve,TProgress> promise, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled, Runnable<ProgressPromise<TResolve,TProgress>,Value<TResolve>> onRejected, Runnable<Value<TProgress>,Value<TProgress>> onProgress) Register an observer for a promise.
ProgressPromise<TResolve,TProgress>	when(TResolve value) Register an observer for an immediate value.
ProgressPromise<TResolve,TProgress>	when(TResolve value, Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled) Register an observer for an immediate value.

Methods inherited from class java.lang.Object

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

Constructor Detail

WhenProgress

public WhenProgress()

Method Detail

when

public ProgressPromise<TResolve,TProgress> when(TResolve value)

Register an observer for an immediate value.

Parameters:

value - the value to provide to returned promise

Returns:

a new ProgressPromise that will complete with the return value of onFulfilled or the provided value if onFulfilled is not supplied.

when

public ProgressPromise<TResolve,TProgress> when(TResolve value,
                                       Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled)

Register an observer for an immediate value.

Parameters:

value - the value to provide to the onFulfilled callback

onFulfilled - callback to be called when value is successfully fulfilled. It will be invoked immediately.

Returns:

a new ProgressPromise that will complete with the return value of onFulfilled or the provided value if onFulfilled is not supplied.

when

public ProgressPromise<TResolve,TProgress> when(Thenable<TResolve,TProgress> promise)

Register an observer for a promise.

Parameters:

promise - a promise whose value is provided to the callbacks.

Returns:

a new ProgressPromise that will complete with the completion value of promise.

when

public ProgressPromise<TResolve,TProgress> when(Thenable<TResolve,TProgress> promise,
                                       Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled)

Register an observer for a promise.

Parameters:

promise - a promise whose value is provided to the callbacks.

onFulfilled - callback to be called when the promise is successfully fulfilled. If the promise is an immediate value, the callback will be invoked immediately.

Returns:

a new ProgressPromise that will complete with the return value of onFulfilled or the completion value of promise if onFulfilled is not supplied.

when

public ProgressPromise<TResolve,TProgress> when(Thenable<TResolve,TProgress> promise,
                                       Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled,
                                       Runnable<ProgressPromise<TResolve,TProgress>,Value<TResolve>> onRejected)

Register an observer for a promise.

Parameters:

promise - a promise whose value is provided to the callbacks.

onFulfilled - callback to be called when the promise is successfully fulfilled. If the promise is an immediate value, the callback will be invoked immediately.

onRejected - callback to be called when the promise is rejected.

Returns:

a new ProgressPromise that will complete with the return value of onFulfilled or onRejected or the completion value of promise if onFulfilled and/or onRejected are not supplied.

when

public ProgressPromise<TResolve,TProgress> when(Thenable<TResolve,TProgress> promise,
                                       Runnable<ProgressPromise<TResolve,TProgress>,TResolve> onFulfilled,
                                       Runnable<ProgressPromise<TResolve,TProgress>,Value<TResolve>> onRejected,
                                       Runnable<Value<TProgress>,Value<TProgress>> onProgress)

Register an observer for a promise.

Parameters:

promise - the promise to observe

onFulfilled - callback to be called when promise is successfully fulfilled.

onRejected - callback to be called when promiseOrValue is rejected.

onProgress - callback to be called when progress updates are issued for promise.

Returns:

a new Promise that will complete with the return value of callback or errback or the completion value of promiseOrValue if callback and/or errback is not supplied.

createPromise0

protected WhenProgress.Promise0 createPromise0(ResolveCallback<TResolve,TProgress> resolver,
                                   PromiseStatus status)

createFulfilledPromise

protected WhenProgress.FulfilledPromise createFulfilledPromise(TResolve value)

createRejectedPromise

protected WhenProgress.RejectedPromise createRejectedPromise(Value<TResolve> value)

createProgressingPromise

protected WhenProgress.ProgressingPromise createProgressingPromise(Value<TProgress> value)

resolve

public ProgressPromise<TResolve,TProgress> resolve(Thenable<TResolve,TProgress> x)

Returns a resolved promise. The returned promise will be - fulfilled with promiseOrValue if it is a value, or - if promiseOrValue is a promise - fulfilled with promiseOrValue's value after it is fulfilled - rejected with promiseOrValue's reason after it is rejected In contract to cast(x), this always creates a new Promise

Parameters:

x - the thenable to resolve

Returns:

{Promise}

resolve

public ProgressPromise<TResolve,TProgress> resolve(TResolve x)

Returns a resolved promise. The returned promise will be - fulfilled with promiseOrValue if it is a value, or - if promiseOrValue is a promise - fulfilled with promiseOrValue's value after it is fulfilled - rejected with promiseOrValue's reason after it is rejected In contract to cast(x), this always creates a new Promise

Parameters:

x - the resolved value

Returns:

{Promise}

reject

public ProgressPromise<TResolve,TProgress> reject(Thenable<TResolve,TProgress> x)

Returns a rejected promise for the supplied promiseOrValue. The returned promise will be rejected with: - promiseOrValue, if it is a value, or - if promiseOrValue is a promise - promiseOrValue's value after it is fulfilled - promiseOrValue's reason after it is rejected

Parameters:

x - the rejected value of the returned promise

Returns:

rejected promise

reject

public ProgressPromise<TResolve,TProgress> reject(Throwable x)

Returns a rejected promise for the supplied promiseOrValue. The returned promise will be rejected with: - promiseOrValue, if it is a value, or - if promiseOrValue is a promise - promiseOrValue's value after it is fulfilled - promiseOrValue's reason after it is rejected

Parameters:

x - the rejected value of the returned promise

Returns:

rejected promise

reject

public ProgressPromise<TResolve,TProgress> reject(Value<TResolve> x)

Returns a rejected promise for the supplied promiseOrValue. The returned promise will be rejected with: - promiseOrValue, if it is a value, or - if promiseOrValue is a promise - promiseOrValue's value after it is fulfilled - promiseOrValue's reason after it is rejected

Parameters:

x - the rejected value of the returned promise

Returns:

rejected promise

reject

public ProgressPromise<TResolve,TProgress> reject(TResolve x)

Returns a rejected promise for the supplied promiseOrValue. The returned promise will be rejected with: - promiseOrValue, if it is a value, or - if promiseOrValue is a promise - promiseOrValue's value after it is fulfilled - promiseOrValue's reason after it is rejected

Parameters:

x - the rejected value of the returned promise

Returns:

rejected promise

defer

public DeferredProgress<TResolve,TProgress> defer()

Creates a {promise, resolver} pair, either or both of which may be given out safely to consumers. The resolver has resolve, reject, and progress. The promise has the extended promise API.

some

public ProgressPromise<List<? extends TResolve>,TProgress> some(List<? extends ProgressPromise<TResolve,TProgress>> promises,
                                                       int howMany)

Initiates a competitive race, returning a promise that will resolve when howMany of the supplied promisesOrValues have resolved, or will reject when it becomes impossible for howMany to resolve, for example, when (promisesOrValues.length - howMany) + 1 input promises reject.

Parameters:

promises - array of anything, may contain a mix of promises and values

howMany - number of promisesOrValues to resolve

Returns:

promise that will resolve to an array of howMany values that resolved first, or will reject with an array of (promisesOrValues.length - howMany) + 1 rejection reasons.

someValues

public ProgressPromise<List<? extends TResolve>,TProgress> someValues(List<TResolve> values,
                                                             int howMany)

Resolves immediately returning a resolved ProgressPromise with the specified number of values.

Parameters:

values - a list of resolved values

howMany - number of promises to resolve

Returns:

a resolved ProgressPromise with howMany values.

any

public ProgressPromise<TResolve,TProgress> any(List<? extends ProgressPromise<TResolve,TProgress>> promises)

Initiates a competitive race, returning a promise that will resolve when any one of the supplied promises has resolved or will reject when *all* promises have rejected.

Parameters:

promises - list of promises

Returns:

promise that will resolve to the value that resolved first, or will reject with an array of all rejected inputs.

anyValues

public ProgressPromise<TResolve,TProgress> anyValues(List<TResolve> values)

Resolves immediately returning a resolved ProgressPromise with the first value from the input list.

Parameters:

values - the values

Returns:

an already-fulfilled ProgressPromise with the first value from the input list.

all

public ProgressPromise<List<? extends TResolve>,TProgress> all(List<? extends ProgressPromise<TResolve,TProgress>> promises)

Return a promise that will resolve only once all the supplied promises have resolved. The resolution value of the returned promise will be a list containing the resolution values of each of the promises.

Parameters:

promises - input promises to resolve

Returns:

a ProgressPromise that resolves when all the input promises have resolved

allValues

public ProgressPromise<List<? extends TResolve>,TProgress> allValues(List<TResolve> values)

Return a resolved promise for the list of input values.

Parameters:

values - input values

Returns:

a resolved ProgressPromise

join

@SafeVarargs
public final ProgressPromise<List<? extends TResolve>,TProgress> join(ProgressPromise<TResolve,TProgress>... promises)

Joins multiple promises into a single returned promise.

Parameters:

promises - the promises to join

Returns:

{Promise} a promise that will fulfill when *all* the input promises have fulfilled, or will reject when *any one* of the input promises rejects.

join

@SafeVarargs
public final ProgressPromise<List<? extends TResolve>,TProgress> join(TResolve... values)

Joins multiple promises into a single returned promise.

Parameters:

values - the values to join

Returns:

{Promise} a promise that will fulfill when *all* the input promises have fulfilled, or will reject when *any one* of the input promises rejects.

map

public ProgressPromise<List<? extends TResolve>,TProgress> map(List<? extends ProgressPromise<TResolve,TProgress>> promises,
                                                      Runnable<ProgressPromise<TResolve,TProgress>,TResolve> mapFunc)

Promise-aware array map function, similar to `Array.prototype.map()`, but input array may contain promises or values.

Parameters:

promises - list of promises, may be in any status

mapFunc - map function which may return a promise or value

Returns:

promise that will fulfill with an array of mapped values or reject if any input promise rejects.

map

public ProgressPromise<List<? extends TResolve>,TProgress> map(ProgressPromise<List<? extends TResolve>,TProgress> promise,
                                                      Runnable<ProgressPromise<TResolve,TProgress>,TResolve> mapFunc)

Traditional map function, but the input is a ProgressPromise for values to be mapped.

Parameters:

promise - a ProgressPromise for a list of values to be mapped

mapFunc - a mapping function that returns a promise for a value

Returns:

a ProgressPromise that will resolve to a list containing the mapped output values.

reduce

public <T> ProgressPromise<T,TProgress> reduce(List<ProgressPromise<TResolve,TProgress>> promises,
                                      Reducer<T,TResolve> reduceFunc)

Traditional reduce function, but the input is a list of ProgressPromises.

Parameters:

promises - list of ProgressPromises for values to reduce

reduceFunc - the reduce function

Returns:

a ProgressPromise that will resolve to the final reduced values.

reduce

public <T> ProgressPromise<T,TProgress> reduce(List<ProgressPromise<TResolve,TProgress>> promises,
                                      Reducer<T,TResolve> reduceFunc,
                                      T initialValue)

Traditional reduce function, but the input is a list of ProgressPromises.

Parameters:

promises - list of ProgressPromises for values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a ProgressPromise that will resolve to the final reduced values.

reduce

public <T> ProgressPromise<T,TProgress> reduce(List<ProgressPromise<TResolve,TProgress>> promises,
                                      Reducer<T,TResolve> reduceFunc,
                                      ProgressPromise<T,TProgress> initialValue)

Traditional reduce function, but the input is a list of ProgressPromises.

Parameters:

promises - list of ProgressPromises for values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a ProgressPromise that will resolve to the final reduced values.

reduce

public <T> ProgressPromise<T,TProgress> reduce(ProgressPromise<List<TResolve>,TProgress> promise,
                                      Reducer<T,TResolve> reduceFunc,
                                      T initialValue)

Traditional reduce function, but the input is a ProgressPromise for a list of values.

Parameters:

promise - a ProgressPromise for values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a ProgressPromise that will resolve to the final reduced values.

reduce

public <T> ProgressPromise<T,TProgress> reduce(ProgressPromise<List<TResolve>,TProgress> promise,
                                      Reducer<T,TResolve> reduceFunc,
                                      ProgressPromise<T,TProgress> initialValue)

Traditional reduce function, but the input is a ProgressPromise for a list of values.

Parameters:

promise - a ProgressPromise for values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a ProgressPromise that will resolve to the final reduced values.

reduceValues

public <T> ProgressPromise<T,TProgress> reduceValues(List<TResolve> values,
                                            Reducer<T,TResolve> reduceFunc)

Traditional reduce function, where the input is a list of values to reduce.

Parameters:

values - a list of values to reduce

reduceFunc - the reduce function

Returns:

a resolved ProgressPromise for the final reduced values.

reduceValues

public <T> ProgressPromise<T,TProgress> reduceValues(List<TResolve> values,
                                            Reducer<T,TResolve> reduceFunc,
                                            T initialValue)

Traditional reduce function, where the input is a list of values to reduce.

Parameters:

values - a list of values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a resolved ProgressPromise for the final reduced values.

reduceValues

public <T> ProgressPromise<T,TProgress> reduceValues(List<TResolve> values,
                                            Reducer<T,TResolve> reduceFunc,
                                            ProgressPromise<T,TProgress> initialValue)

Traditional reduce function, where the input is a list of values to reduce.

Parameters:

values - a list of values to reduce

reduceFunc - the reduce function

initialValue - the initial value. If null is provided, it will be used as the initial value.

Returns:

a resolved ProgressPromise for the final reduced values.

chain

public ProgressPromise<TResolve,TProgress> chain(ProgressPromise<TResolve,TProgress> promise,
                                        Resolver<TResolve,TProgress> resolver)

Ensure that resolution of a promise will trigger the resolver with the resolved value.

Parameters:

promise - the ProgressPromise that when resolved/rejected will trigger the resolver.

resolver - the resolver to be triggered.

Returns:

a ProgressPromise for the input promise

chain

public ProgressPromise<TResolve,TProgress> chain(ProgressPromise<TResolve,TProgress> promise,
                                        Resolver<TResolve,TProgress> resolver,
                                        TResolve resolveValue)

Ensure that resolution of a promise will trigger the resolver with the provided resolveValue.

Parameters:

promise - the ProgressPromise that when resolved/rejected will trigger the resolver.

resolver - the resolver to be triggered.

resolveValue - the value to be provided to the resolver.

Returns:

a ProgressPromise for the input promise

sequence

public ProgressPromise<List<TResolve>,TProgress> sequence(List<Runnable<ProgressPromise<TResolve,TProgress>,Void>> tasks)

Run list of tasks in sequence with no overlap

Parameters:

tasks - tasks to be executed

Returns:

ProgressPromise for a list containing the result of each task in the in the list position corresponding to the position of the task in the task list

sequence

public <TArg> ProgressPromise<List<TResolve>,TProgress> sequence(List<Runnable<ProgressPromise<TResolve,TProgress>,TArg>> tasks,
                                                        TArg arg)

Run list of tasks in sequence with no overlap

Type Parameters:

TArg - the argument type being passed to each task

Parameters:

tasks - tasks to be executed

arg - argument to be passed to all tasks

Returns:

ProgressPromise for a list containing the result of each task in the in the list position corresponding to the position of the task in the task list

getMonitorApi

protected static MonitorApi getMonitorApi()

setNextTick

public static void setNextTick(Executor executor)

Sets the executor to asynchronously run callbacks on an event loop.

Parameters:

executor -

resolveValues

public List<ProgressPromise<TResolve,TProgress>> resolveValues(List<? extends TResolve> values)

Converts a list of values to a list of resolved promises. If a null input list is provided, a null list is returned.

Parameters:

values - the values to resolve

Returns:

a list of already-resolved promises for the input values