Package org.jdeferred2
Interface DeferredManager
-
- All Known Implementing Classes:
AbstractDeferredManager
,DefaultDeferredManager
public interface DeferredManager
DeferredManager
is especially useful when dealing with asynchronous tasks, eitherRunnable
orCallable
objects.It's also very useful when you need to get callbacks from multiple
Promise
objects.DeferredManager
dm = newDefaultDeferredManager
();Promise
p1, p2, p3; // p1 = ...; p2 = ...; p3 = ...; dm.when(p1, p2, p3) .done(new DoneCallback() { ... }) .fail(new FailCallback() { ... }) .progress(new ProgressCallback() { ... })When dealing with async threads:
dm.when(new Callable() { ... }, new Callable() { ... }) .done(new DoneCallback() { ... }) .fail(new FailCallback() { ... })
- See Also:
DefaultDeferredManager
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
DeferredManager.StartPolicy
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(java.lang.Iterable<?> iterable)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(java.lang.Runnable runnableV1, java.lang.Runnable runnableV2, java.lang.Runnable... runnables)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(java.util.concurrent.Callable<?> callableV1, java.util.concurrent.Callable<?> callableV2, java.util.concurrent.Callable<?>... callables)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(java.util.concurrent.Future<?> futureV1, java.util.concurrent.Future<?> futureV2, java.util.concurrent.Future<?>... futures)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(DeferredCallable<?,?> callableV1, DeferredCallable<?,?> callableV2, DeferredCallable<?,?>... callables)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(DeferredFutureTask<?,?> taskV1, DeferredFutureTask<?,?> taskV2, DeferredFutureTask<?,?>... tasks)
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void>
race(DeferredRunnable<?> runnableV1, DeferredRunnable<?> runnableV2, DeferredRunnable<?>... runnables)
<D,F,P>
Promise<D,F,P>reject(F reject)
A convenience method to create aPromise
that immediately fails with a reason.<D,F,P>
Promise<D,F,P>resolve(D resolve)
A convenience method create aPromise
that immediately resolves to a value.Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(java.lang.Iterable<?> iterable)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(java.lang.Runnable runnableV1, java.lang.Runnable runnableV2, java.lang.Runnable... runnables)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(java.util.concurrent.Callable<?> callableV1, java.util.concurrent.Callable<?> callableV2, java.util.concurrent.Callable<?>... callables)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(java.util.concurrent.Future<?> futureV1, java.util.concurrent.Future<?> futureV2, java.util.concurrent.Future<?>... futures)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(DeferredCallable<?,?> callableV1, DeferredCallable<?,?> callableV2, DeferredCallable<?,?>... callables)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(DeferredFutureTask<?,?> taskV1, DeferredFutureTask<?,?> taskV2, DeferredFutureTask<?,?>... tasks)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(DeferredRunnable<?> runnableV1, DeferredRunnable<?> runnableV2, DeferredRunnable<?>... runnables)
Promise<AllValues,java.lang.Throwable,MasterProgress>
settle(Promise<?,?,?> promiseV1, Promise<?,?,?> promiseV2, Promise<?,?,?>... promises)
Promise<MultipleResults,OneReject<?>,MasterProgress>
when(java.lang.Iterable<?> iterable)
Accept an iterable of a variety of different object types, and convert it into corresponding Promise.Promise<java.lang.Void,java.lang.Throwable,java.lang.Void>
when(java.lang.Runnable runnable)
WrapsRunnable
withDeferredFutureTask
.Promise<MultipleResults,OneReject<java.lang.Throwable>,MasterProgress>
when(java.lang.Runnable runnable1, java.lang.Runnable runnable2, java.lang.Runnable... runnables)
WrapsRunnable
withDeferredFutureTask
<D> Promise<D,java.lang.Throwable,java.lang.Void>
when(java.util.concurrent.Callable<D> callable)
WrapsCallable
withDeferredFutureTask
<V1,V2>
Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2)
Submits 2Callable
s returns a combinedPromise
.<V1,V2,V3>
Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3)
Submits 3Callable
s returns a combinedPromise
.<V1,V2,V3,V4>
Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4)
Submits 4Callable
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4, java.util.concurrent.Callable<V5> callableV5)
Submits 5Callable
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4, java.util.concurrent.Callable<V5> callableV5, java.util.concurrent.Callable<?> callable6, java.util.concurrent.Callable<?>... callables)
<D> Promise<D,java.lang.Throwable,java.lang.Void>
when(java.util.concurrent.Future<D> future)
WrapsFuture
and waits forFuture.get()
to return a result in the background.<V1,V2>
Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2)
Submits 2Future
s returns a combinedPromise
.<V1,V2,V3>
Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3)
Submits 3Future
s returns a combinedPromise
.<V1,V2,V3,V4>
Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4)
Submits 4Future
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4, java.util.concurrent.Future<V5> futureV5)
Submits 5Future
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4, java.util.concurrent.Future<V5> futureV5, java.util.concurrent.Future<?> future6, java.util.concurrent.Future<?>... futures)
<D,P>
Promise<D,java.lang.Throwable,P>when(DeferredCallable<D,P> callable)
WrapsDeferredCallable
withDeferredFutureTask
<V1,V2>
Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2)
Submits 2DeferredCallable
s returns a combinedPromise
.<V1,V2,V3>
Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3)
Submits 3DeferredCallable
s returns a combinedPromise
.<V1,V2,V3,V4>
Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4)
Submits 4DeferredCallable
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4, DeferredCallable<V5,?> callableV5)
Submits 5DeferredCallable
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4, DeferredCallable<V5,?> callableV5, DeferredCallable<?,?> callable6, DeferredCallable<?,?>... callables)
<D,P>
Promise<D,java.lang.Throwable,P>when(DeferredFutureTask<D,P> task)
May or may not submitDeferredFutureTask
for execution.<V1,V2>
Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2)
Submits 2DeferredFutureTask
s returns a combinedPromise
.<V1,V2,V3>
Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3)
Submits 3DeferredFutureTask
s returns a combinedPromise
.<V1,V2,V3,V4>
Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4)
Submits 4DeferredFutureTask
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4, DeferredFutureTask<V5,?> taskV5)
Submits 5DeferredFutureTask
s returns a combinedPromise
.<V1,V2,V3,V4,V5>
Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4, DeferredFutureTask<V5,?> taskV5, DeferredFutureTask<?,?> task6, DeferredFutureTask<?,?>... tasks)
<P> Promise<java.lang.Void,java.lang.Throwable,P>
when(DeferredRunnable<P> runnable)
WrapsDeferredRunnable
withDeferredFutureTask
<P1,P2>
Promise<MultipleResults2<java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2)
Submits 2DeferredRunnable
s returns a combinedPromise
.<P1,P2,P3>
Promise<MultipleResults3<java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3)
Submits 3DeferredRunnable
s returns a combinedPromise
.<P1,P2,P3,P4>
Promise<MultipleResults4<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4)
Submits 4DeferredRunnable
s returns a combinedPromise
.<P1,P2,P3,P4,P5>
Promise<MultipleResults5<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4, DeferredRunnable<P5> runnableP5)
Submits 5DeferredRunnable
s returns a combinedPromise
.<P1,P2,P3,P4,P5>
Promise<MultipleResultsN<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress>when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4, DeferredRunnable<P5> runnableP5, DeferredRunnable<?> runnable6, DeferredRunnable<?>... runnables)
<D,F,P>
Promise<D,F,P>when(Promise<D,F,P> promise)
Simply returns the promise.<F,V1,V2>
Promise<MultipleResults2<V1,V2>,OneReject<F>,MasterProgress>when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2)
Submits 2Promise
s returns a combinedPromise
.<F,V1,V2,V3>
Promise<MultipleResults3<V1,V2,V3>,OneReject<F>,MasterProgress>when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3)
Submits 3Promise
s returns a combinedPromise
.<F,V1,V2,V3,V4>
Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<F>,MasterProgress>when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4)
Submits 4Promise
s returns a combinedPromise
.<F,V1,V2,V3,V4,V5>
Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<F>,MasterProgress>when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4, Promise<V5,?,?> promiseV5)
Submits 5Promise
s returns a combinedPromise
.<F,V1,V2,V3,V4,V5>
Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<F>,MasterProgress>when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4, Promise<V5,?,?> promiseV5, Promise<?,?,?> promise6, Promise<?,?,?>... promises)
-
-
-
Method Detail
-
when
<D,F,P> Promise<D,F,P> when(Promise<D,F,P> promise)
Simply returns the promise.- Parameters:
promise
-- Returns:
- promise
-
when
Promise<java.lang.Void,java.lang.Throwable,java.lang.Void> when(java.lang.Runnable runnable)
WrapsRunnable
withDeferredFutureTask
.- Parameters:
runnable
-- Returns:
when(DeferredFutureTask)
- See Also:
when(DeferredFutureTask)
-
when
<D> Promise<D,java.lang.Throwable,java.lang.Void> when(java.util.concurrent.Callable<D> callable)
WrapsCallable
withDeferredFutureTask
- Parameters:
callable
-- Returns:
when(DeferredFutureTask)
- See Also:
when(DeferredFutureTask)
-
when
<D> Promise<D,java.lang.Throwable,java.lang.Void> when(java.util.concurrent.Future<D> future)
WrapsFuture
and waits forFuture.get()
to return a result in the background.- Parameters:
future
-- Returns:
when(Callable)
-
when
<P> Promise<java.lang.Void,java.lang.Throwable,P> when(DeferredRunnable<P> runnable)
WrapsDeferredRunnable
withDeferredFutureTask
- Parameters:
runnable
-- Returns:
when(DeferredFutureTask)
- See Also:
when(DeferredFutureTask)
-
when
<D,P> Promise<D,java.lang.Throwable,P> when(DeferredCallable<D,P> callable)
WrapsDeferredCallable
withDeferredFutureTask
- Parameters:
callable
-- Returns:
when(DeferredFutureTask)
- See Also:
when(DeferredFutureTask)
-
when
<D,P> Promise<D,java.lang.Throwable,P> when(DeferredFutureTask<D,P> task)
May or may not submitDeferredFutureTask
for execution. See implementation documentation.- Parameters:
task
-- Returns:
DeferredFutureTask.promise()
-
when
<F,V1,V2> Promise<MultipleResults2<V1,V2>,OneReject<F>,MasterProgress> when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2)
Submits 2Promise
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the promises rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
F
- the common type the promises may rejectV1
- the resolve type of the first promiseV2
- the resolve type of the second promise- Parameters:
promiseV1
- the first promise to be resolvedpromiseV2
- the second promise to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<F,V1,V2,V3> Promise<MultipleResults3<V1,V2,V3>,OneReject<F>,MasterProgress> when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3)
Submits 3Promise
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the promises rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
F
- the common type the promises may rejectV1
- the resolve type of the first promiseV2
- the resolve type of the second promiseV3
- the resolve type of the third promise- Parameters:
promiseV1
- the first promise to be resolvedpromiseV2
- the second promise to be resolvedpromiseV3
- the third promise to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<F,V1,V2,V3,V4> Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<F>,MasterProgress> when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4)
Submits 4Promise
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the promises rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
F
- the common type the promises may rejectV1
- the resolve type of the first promiseV2
- the resolve type of the second promiseV3
- the resolve type of the third promiseV4
- the resolve type of the fourth promise- Parameters:
promiseV1
- the first promise to be resolvedpromiseV2
- the second promise to be resolvedpromiseV3
- the third promise to be resolvedpromiseV4
- the fourth promise to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<F,V1,V2,V3,V4,V5> Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<F>,MasterProgress> when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4, Promise<V5,?,?> promiseV5)
Submits 5Promise
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the promises rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
F
- the common type the promises may rejectV1
- the resolve type of the first promiseV2
- the resolve type of the second promiseV3
- the resolve type of the third promiseV4
- the resolve type of the fourth promiseV5
- the resolve type of the fifth promise- Parameters:
promiseV1
- the first promise to be resolvedpromiseV2
- the second promise to be resolvedpromiseV3
- the third promise to be resolvedpromiseV4
- the fourth promise to be resolvedpromiseV5
- the fifth promise to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<F,V1,V2,V3,V4,V5> Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<F>,MasterProgress> when(Promise<V1,?,?> promiseV1, Promise<V2,?,?> promiseV2, Promise<V3,?,?> promiseV3, Promise<V4,?,?> promiseV4, Promise<V5,?,?> promiseV5, Promise<?,?,?> promise6, Promise<?,?,?>... promises)
SubmitsN
Promise
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the promises rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
F
- the common type the promises may rejectV1
- the resolve type of the first promiseV2
- the resolve type of the second promiseV3
- the resolve type of the third promiseV4
- the resolve type of the fourth promiseV5
- the resolve type of the fifth promise- Parameters:
promiseV1
- the first promise to be resolvedpromiseV2
- the second promise to be resolvedpromiseV3
- the third promise to be resolvedpromiseV4
- the fourth promise to be resolvedpromiseV5
- the fifth promise to be resolvedpromises
- additional promises to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
Promise<MultipleResults,OneReject<java.lang.Throwable>,MasterProgress> when(java.lang.Runnable runnable1, java.lang.Runnable runnable2, java.lang.Runnable... runnables)
WrapsRunnable
withDeferredFutureTask
- Parameters:
runnable1
- the first runnablerunnable2
- the second runnablerunnables
- additional runnables- See Also:
when(DeferredFutureTask)
,when(DeferredFutureTask, DeferredFutureTask, DeferredFutureTask, DeferredFutureTask, DeferredFutureTask, DeferredFutureTask, DeferredFutureTask...)
-
when
<V1,V2> Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2)
Submits 2Callable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3> Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3)
Submits 3Callable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4> Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4)
Submits 4Callable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4, java.util.concurrent.Callable<V5> callableV5)
Submits 5Callable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callableV5
- the resolve type of the fifth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolvedcallableV5
- the fifth callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Callable<V1> callableV1, java.util.concurrent.Callable<V2> callableV2, java.util.concurrent.Callable<V3> callableV3, java.util.concurrent.Callable<V4> callableV4, java.util.concurrent.Callable<V5> callableV5, java.util.concurrent.Callable<?> callable6, java.util.concurrent.Callable<?>... callables)
SubmitsN
Callable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callableV5
- the resolve type of the fifth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolvedcallableV5
- the fifth callable to be resolvedcallables
- additional callables to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<P1,P2> Promise<MultipleResults2<java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2)
Submits 2DeferredRunnable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the runnables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
P1
- the progress type of the first runnableP2
- the progress type of the second runnable- Parameters:
runnableP1
- the first runnable to be resolvedrunnableP2
- the second runnable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<P1,P2,P3> Promise<MultipleResults3<java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3)
Submits 3DeferredRunnable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the runnables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
P1
- the progress type of the first runnableP2
- the progress type of the second runnableP3
- the progress type of the third runnable- Parameters:
runnableP1
- the first runnable to be resolvedrunnableP2
- the second runnable to be resolvedrunnableP3
- the third runnable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<P1,P2,P3,P4> Promise<MultipleResults4<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4)
Submits 4DeferredRunnable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the runnables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
P1
- the progress type of the first runnableP2
- the progress type of the second runnableP3
- the progress type of the third runnableP4
- the progress type of the fourth runnable- Parameters:
runnableP1
- the first runnable to be resolvedrunnableP2
- the second runnable to be resolvedrunnableP3
- the third runnable to be resolvedrunnableP4
- the fourth runnable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<P1,P2,P3,P4,P5> Promise<MultipleResults5<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4, DeferredRunnable<P5> runnableP5)
Submits 5DeferredRunnable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the runnables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
P1
- the progress type of the first runnableP2
- the progress type of the second runnableP3
- the progress type of the third runnableP4
- the progress type of the fourth runnableP5
- the progress type of the fifth runnable- Parameters:
runnableP1
- the first runnable to be resolvedrunnableP2
- the second runnable to be resolvedrunnableP3
- the third runnable to be resolvedrunnableP4
- the fourth runnable to be resolvedrunnableP5
- the fifth runnable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<P1,P2,P3,P4,P5> Promise<MultipleResultsN<java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void,java.lang.Void>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredRunnable<P1> runnableP1, DeferredRunnable<P2> runnableP2, DeferredRunnable<P3> runnableP3, DeferredRunnable<P4> runnableP4, DeferredRunnable<P5> runnableP5, DeferredRunnable<?> runnable6, DeferredRunnable<?>... runnables)
SubmitsN
DeferredRunnable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the runnables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
P1
- the progress type of the first runnableP2
- the progress type of the second runnableP3
- the progress type of the third runnableP4
- the progress type of the fourth runnableP5
- the progress type of the fifth runnable- Parameters:
runnableP1
- the first runnable to be resolvedrunnableP2
- the second runnable to be resolvedrunnableP3
- the third runnable to be resolvedrunnableP4
- the fourth runnable to be resolvedrunnableP5
- the fifth runnable to be resolvedrunnables
- additional runnables to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2> Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2)
Submits 2DeferredCallable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3> Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3)
Submits 3DeferredCallable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4> Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4)
Submits 4DeferredCallable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4, DeferredCallable<V5,?> callableV5)
Submits 5DeferredCallable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callableV5
- the resolve type of the fifth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolvedcallableV5
- the fifth callable to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredCallable<V1,?> callableV1, DeferredCallable<V2,?> callableV2, DeferredCallable<V3,?> callableV3, DeferredCallable<V4,?> callableV4, DeferredCallable<V5,?> callableV5, DeferredCallable<?,?> callable6, DeferredCallable<?,?>... callables)
SubmitsN
DeferredCallable
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the callables rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first callableV2
- the resolve type of the second callableV3
- the resolve type of the third callableV4
- the resolve type of the fourth callableV5
- the resolve type of the fifth callable- Parameters:
callableV1
- the first callable to be resolvedcallableV2
- the second callable to be resolvedcallableV3
- the third callable to be resolvedcallableV4
- the fourth callable to be resolvedcallableV5
- the fifth callable to be resolvedcallables
- additional callables to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2> Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2)
Submits 2DeferredFutureTask
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the tasks rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first taskV2
- the resolve type of the second task- Parameters:
taskV1
- the first task to be resolvedtaskV2
- the second task to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3> Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3)
Submits 3DeferredFutureTask
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the tasks rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first taskV2
- the resolve type of the second taskV3
- the resolve type of the third task- Parameters:
taskV1
- the first task to be resolvedtaskV2
- the second task to be resolvedtaskV3
- the third task to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4> Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4)
Submits 4DeferredFutureTask
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the tasks rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first taskV2
- the resolve type of the second taskV3
- the resolve type of the third taskV4
- the resolve type of the fourth task- Parameters:
taskV1
- the first task to be resolvedtaskV2
- the second task to be resolvedtaskV3
- the third task to be resolvedtaskV4
- the fourth task to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4, DeferredFutureTask<V5,?> taskV5)
Submits 5DeferredFutureTask
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the tasks rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first taskV2
- the resolve type of the second taskV3
- the resolve type of the third taskV4
- the resolve type of the fourth taskV5
- the resolve type of the fifth task- Parameters:
taskV1
- the first task to be resolvedtaskV2
- the second task to be resolvedtaskV3
- the third task to be resolvedtaskV4
- the fourth task to be resolvedtaskV5
- the fifth task to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(DeferredFutureTask<V1,?> taskV1, DeferredFutureTask<V2,?> taskV2, DeferredFutureTask<V3,?> taskV3, DeferredFutureTask<V4,?> taskV4, DeferredFutureTask<V5,?> taskV5, DeferredFutureTask<?,?> task6, DeferredFutureTask<?,?>... tasks)
SubmitsN
DeferredFutureTask
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the tasks rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first taskV2
- the resolve type of the second taskV3
- the resolve type of the third taskV4
- the resolve type of the fourth taskV5
- the resolve type of the fifth task- Parameters:
taskV1
- the first task to be resolvedtaskV2
- the second task to be resolvedtaskV3
- the third task to be resolvedtaskV4
- the fourth task to be resolvedtaskV5
- the fifth task to be resolvedtasks
- additional tasks to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2> Promise<MultipleResults2<V1,V2>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2)
Submits 2Future
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the futures rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first futureV2
- the resolve type of the second future- Parameters:
futureV1
- the first future to be resolvedfutureV2
- the second future to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3> Promise<MultipleResults3<V1,V2,V3>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3)
Submits 3Future
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the futures rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first futureV2
- the resolve type of the second futureV3
- the resolve type of the third future- Parameters:
futureV1
- the first future to be resolvedfutureV2
- the second future to be resolvedfutureV3
- the third future to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4> Promise<MultipleResults4<V1,V2,V3,V4>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4)
Submits 4Future
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the futures rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first futureV2
- the resolve type of the second futureV3
- the resolve type of the third futureV4
- the resolve type of the fourth future- Parameters:
futureV1
- the first future to be resolvedfutureV2
- the second future to be resolvedfutureV3
- the third future to be resolvedfutureV4
- the fourth future to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResults5<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4, java.util.concurrent.Future<V5> futureV5)
Submits 5Future
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the futures rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first futureV2
- the resolve type of the second futureV3
- the resolve type of the third futureV4
- the resolve type of the fourth futureV5
- the resolve type of the fifth future- Parameters:
futureV1
- the first future to be resolvedfutureV2
- the second future to be resolvedfutureV3
- the third future to be resolvedfutureV4
- the fourth future to be resolvedfutureV5
- the fifth future to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
when
<V1,V2,V3,V4,V5> Promise<MultipleResultsN<V1,V2,V3,V4,V5>,OneReject<java.lang.Throwable>,MasterProgress> when(java.util.concurrent.Future<V1> futureV1, java.util.concurrent.Future<V2> futureV2, java.util.concurrent.Future<V3> futureV3, java.util.concurrent.Future<V4> futureV4, java.util.concurrent.Future<V5> futureV5, java.util.concurrent.Future<?> future6, java.util.concurrent.Future<?>... futures)
SubmitsN
Future
s returns a combinedPromise
. The combined promise signalsfail
as soon as any of the futures rejects its value. The return type of the combinedPromise
contains all resolved values.- Type Parameters:
V1
- the resolve type of the first futureV2
- the resolve type of the second futureV3
- the resolve type of the third futureV4
- the resolve type of the fourth futureV5
- the resolve type of the fifth future- Parameters:
futureV1
- the first future to be resolvedfutureV2
- the second future to be resolvedfutureV3
- the third future to be resolvedfutureV4
- the fourth future to be resolvedfutureV5
- the fifth future to be resolvedfutures
- additional futures to be resolved- Returns:
- a combined
Promise
- Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(java.lang.Runnable runnableV1, java.lang.Runnable runnableV2, java.lang.Runnable... runnables)
Creates aPromise
that signalsdone
orreject
when the first runnable does so. Wraps eachrunnable
withDeferredFutureTask
.- Parameters:
runnableV1
- a task to be executed. Must not be nullrunnableV2
- a task to be executed. Must not be nullrunnables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(java.util.concurrent.Callable<?> callableV1, java.util.concurrent.Callable<?> callableV2, java.util.concurrent.Callable<?>... callables)
Creates aPromise
that signalsdone
orreject
when the first callable does so. Wraps eachcallable
withDeferredFutureTask
.- Parameters:
callableV1
- a task to be executed. Must not be nullcallableV2
- a task to be executed. Must not be nullcallables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(DeferredRunnable<?> runnableV1, DeferredRunnable<?> runnableV2, DeferredRunnable<?>... runnables)
Creates aPromise
that signalsdone
orreject
when the first runnable does so. Wraps eachrunnable
withDeferredFutureTask
.- Parameters:
runnableV1
- a task to be executed. Must not be nullrunnableV2
- a task to be executed. Must not be nullrunnables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(DeferredCallable<?,?> callableV1, DeferredCallable<?,?> callableV2, DeferredCallable<?,?>... callables)
Creates aPromise
that signalsdone
orreject
when the first callable does so. Wraps eachcallable
withDeferredFutureTask
.- Parameters:
callableV1
- a task to be executed. Must not be nullcallableV2
- a task to be executed. Must not be nullcallables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(java.util.concurrent.Future<?> futureV1, java.util.concurrent.Future<?> futureV2, java.util.concurrent.Future<?>... futures)
Creates aPromise
that signalsdone
orreject
when the first future does so. Wraps eachfuture
withDeferredFutureTask
.- Parameters:
futureV1
- a task to be executed. Must not be nullfutureV2
- a task to be executed. Must not be nullfutures
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(DeferredFutureTask<?,?> taskV1, DeferredFutureTask<?,?> taskV2, DeferredFutureTask<?,?>... tasks)
- Parameters:
taskV1
- a task to be executed. Must not be nulltaskV2
- a task to be executed. Must not be nulltasks
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(java.lang.Runnable runnableV1, java.lang.Runnable runnableV2, java.lang.Runnable... runnables)
Creates aPromise
that signalsdone
orreject
when each runnable does so. Wraps eachrunnable
withDeferredFutureTask
.- Parameters:
runnableV1
- a task to be executed. Must not be nullrunnableV2
- a task to be executed. Must not be nullrunnables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(java.util.concurrent.Callable<?> callableV1, java.util.concurrent.Callable<?> callableV2, java.util.concurrent.Callable<?>... callables)
Creates aPromise
that signalsdone
orreject
when each callable does so. Wraps eachcallable
withDeferredFutureTask
.- Parameters:
callableV1
- a task to be executed. Must not be nullcallableV2
- a task to be executed. Must not be nullcallables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(DeferredRunnable<?> runnableV1, DeferredRunnable<?> runnableV2, DeferredRunnable<?>... runnables)
Creates aPromise
that signalsdone
orreject
when each runnable does so. Wraps eachrunnable
withDeferredFutureTask
.- Parameters:
runnableV1
- a task to be executed. Must not be nullrunnableV2
- a task to be executed. Must not be nullrunnables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(DeferredCallable<?,?> callableV1, DeferredCallable<?,?> callableV2, DeferredCallable<?,?>... callables)
Creates aPromise
that signalsdone
orreject
when each callable does so. Wraps eachcallable
withDeferredFutureTask
.- Parameters:
callableV1
- a task to be executed. Must not be nullcallableV2
- a task to be executed. Must not be nullcallables
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(java.util.concurrent.Future<?> futureV1, java.util.concurrent.Future<?> futureV2, java.util.concurrent.Future<?>... futures)
Creates aPromise
that signalsdone
orreject
when each future does so. Wraps eachfuture
withDeferredFutureTask
.- Parameters:
futureV1
- a task to be executed. Must not be nullfutureV2
- a task to be executed. Must not be nullfutures
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(DeferredFutureTask<?,?> taskV1, DeferredFutureTask<?,?> taskV2, DeferredFutureTask<?,?>... tasks)
- Parameters:
taskV1
- a task to be executed. Must not be nulltaskV2
- a task to be executed. Must not be nulltasks
- additional tasks to be executed. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all tasks. - Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(Promise<?,?,?> promiseV1, Promise<?,?,?> promiseV2, Promise<?,?,?>... promises)
- Parameters:
promiseV1
- a promise. Must not be nullpromiseV2
- a promise. Must not be nullpromises
- additional promises. May be null- Returns:
- a composite
Promise
that collects resolve/reject values from all promises. - Since:
- 2.0
-
when
Promise<MultipleResults,OneReject<?>,MasterProgress> when(java.lang.Iterable<?> iterable)
Accept an iterable of a variety of different object types, and convert it into corresponding Promise. E.g., if an item is aCallable
, it'll callwhen(Callable)
to convert that into a Promise.If the item is of an unknown type, it'll throw an
IllegalArgumentException
.- Parameters:
iterable
- the source of tasks. Must be non-null and not empty. Every item must be convertible toPromise
- Returns:
- a composite
Promise
that rejects as soon as the first of the submitted tasks is rejected or contains the resolution of all given tasks. - Throws:
java.lang.IllegalArgumentException
- if any item in iterable cannot be converted to aPromise
- Since:
- 2.0
-
race
Promise<OneResult<?>,OneReject<java.lang.Throwable>,java.lang.Void> race(java.lang.Iterable<?> iterable)
Creates aPromise
that signalsdone
orreject
when the first task does so. If an item is aCallable
, it'll callwhen(Callable)
to convert that into a Promise.If the item is of an unknown type, it'll throw an
IllegalArgumentException
. WARNING: does not accept items of typePromise
.- Parameters:
iterable
- the source of tasks. Must be non-null and not empty. Every item must be convertible toPromise
- Returns:
- a composite
Promise
that resolves/rejects as soon as the first of the submitted tasks is resolved/rejected. - Throws:
java.lang.IllegalArgumentException
- if any item in iterable cannot be converted to aPromise
- Since:
- 2.0
-
settle
Promise<AllValues,java.lang.Throwable,MasterProgress> settle(java.lang.Iterable<?> iterable)
Creates aPromise
that signalsdone
orreject
when each task does so. If an item is aCallable
, it'll callwhen(Callable)
to convert that into a Promise.If the item is of an unknown type, it'll throw an
IllegalArgumentException
.- Parameters:
iterable
- the source of tasks. Must be non-null and not empty. Every item must be convertible toPromise
- Returns:
- a composite
Promise
that collects resolve/reject values from all promises. - Throws:
java.lang.IllegalArgumentException
- if any item in iterable cannot be converted to aPromise
- Since:
- 2.0
-
resolve
<D,F,P> Promise<D,F,P> resolve(D resolve)
A convenience method create aPromise
that immediately resolves to a value.- Parameters:
resolve
- value to resolve to- Returns:
- a Promise that resolves to value
- Since:
- 2.0
-
-