com.landawn.abacus.util

Class Futures

java.lang.Object

com.landawn.abacus.util.Futures

public final class Futures
extends Object

Since:

0.9

Author:

Haiyang Li

Method Summary

Modifier and Type	Method and Description
static <T> ContinuableFuture<List<T>>	allOf(Collection<? extends Future<? extends T>> cfs) Returns a new Future that is completed when all of the given Futures complete.
static <T> ContinuableFuture<List<T>>	allOf(Future<? extends T>... cfs) Returns a new Future that is completed when all of the given Futures complete.
static <T> ContinuableFuture<T>	anyOf(Collection<? extends Future<? extends T>> cfs) Returns a new Future that, when any of the given Futures complete normally.
static <T> ContinuableFuture<T>	anyOf(Future<? extends T>... cfs) Returns a new Future that, when any of the given Futures complete normally.
static <T,R,E extends Exception> ContinuableFuture<R>	combine(Collection<? extends Future<? extends T>> cfs, Throwables.Function<List<T>,R,E> action)
static <T1,T2,E extends Exception> ContinuableFuture<Tuple.Tuple2<T1,T2>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2)
static <T1,T2,T3,E extends Exception> ContinuableFuture<Tuple.Tuple3<T1,T2,T3>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3)
static <T1,T2,T3,T4,E extends Exception> ContinuableFuture<Tuple.Tuple4<T1,T2,T3,T4>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3, Future<? extends T4> cf4)
static <T1,T2,T3,T4,T5,E extends Exception> ContinuableFuture<Tuple.Tuple5<T1,T2,T3,T4,T5>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3, Future<? extends T4> cf4, Future<? extends T5> cf5)
static <T1,T2,T3,T4,T5,T6,E extends Exception> ContinuableFuture<Tuple.Tuple6<T1,T2,T3,T4,T5,T6>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3, Future<? extends T4> cf4, Future<? extends T5> cf5, Future<? extends T6> cf6)
static <T1,T2,T3,T4,T5,T6,T7,E extends Exception> ContinuableFuture<Tuple.Tuple7<T1,T2,T3,T4,T5,T6,T7>>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3, Future<? extends T4> cf4, Future<? extends T5> cf5, Future<? extends T6> cf6, Future<? extends T7> cf7)
static <T1,T2,T3,R,E extends Exception> ContinuableFuture<R>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Future<? extends T3> cf3, Throwables.TriFunction<? super T1,? super T2,? super T3,R,E> action)
static <T1,T2,R,E extends Exception> ContinuableFuture<R>	combine(Future<? extends T1> cf1, Future<? extends T2> cf2, Throwables.BiFunction<? super T1,? super T2,R,E> action)
static <T,FC extends Collection<? extends Future<? extends T>>,R> ContinuableFuture<R>	compose(FC cfs, Throwables.Function<? super FC,R,Exception> zipFunctionForGet)
static <T,FC extends Collection<? extends Future<? extends T>>,R> ContinuableFuture<R>	compose(FC cfs, Throwables.Function<? super FC,R,Exception> zipFunctionForGet, Throwables.Function<? super Tuple.Tuple3<FC,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)
static <T1,T2,T3,R> ContinuableFuture<R>	compose(Future<T1> cf1, Future<T2> cf2, Future<T3> cf3, Throwables.TriFunction<? super Future<T1>,? super Future<T2>,? super Future<T3>,R,Exception> zipFunctionForGet)
static <T1,T2,T3,R> ContinuableFuture<R>	compose(Future<T1> cf1, Future<T2> cf2, Future<T3> cf3, Throwables.TriFunction<? super Future<T1>,? super Future<T2>,? super Future<T3>,R,Exception> zipFunctionForGet, Throwables.Function<? super Tuple.Tuple5<Future<T1>,Future<T2>,Future<T3>,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)
static <T1,T2,R> ContinuableFuture<R>	compose(Future<T1> cf1, Future<T2> cf2, Throwables.BiFunction<? super Future<T1>,? super Future<T2>,R,Exception> zipFunctionForGet)
static <T1,T2,R> ContinuableFuture<R>	compose(Future<T1> cf1, Future<T2> cf2, Throwables.BiFunction<? super Future<T1>,? super Future<T2>,R,Exception> zipFunctionForGet, Throwables.Function<? super Tuple.Tuple4<Future<T1>,Future<T2>,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)
static <T> ObjIterator<T>	iterate(Collection<? extends Future<? extends T>> cfs)
static <T> ObjIterator<T>	iterate(Collection<? extends Future<? extends T>> cfs, long totalTimeoutForAll, TimeUnit unit)
static <T> ObjIterator<T>	iterate(Future<? extends T>... cfs)
static <T> ObjIterator<Pair<T,Exception>>	iteratte(Collection<? extends Future<? extends T>> cfs)
static <T> ObjIterator<Pair<T,Exception>>	iteratte(Collection<? extends Future<? extends T>> cfs, long totalTimeoutForAll, TimeUnit unit)
static <T> ObjIterator<Pair<T,Exception>>	iteratte(Future<? extends T>... cfs)

Methods inherited from class java.lang.Object

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

Method Detail

compose

public static <T1,T2,R> ContinuableFuture<R> compose(Future<T1> cf1,
                                                     Future<T2> cf2,
                                                     Throwables.BiFunction<? super Future<T1>,? super Future<T2>,R,Exception> zipFunctionForGet)

Type Parameters:

T1 -

T2 -

R -

Parameters:

cf1 -

cf2 -

zipFunctionForGet -

Returns:

compose

public static <T1,T2,R> ContinuableFuture<R> compose(Future<T1> cf1,
                                                     Future<T2> cf2,
                                                     Throwables.BiFunction<? super Future<T1>,? super Future<T2>,R,Exception> zipFunctionForGet,
                                                     Throwables.Function<? super Tuple.Tuple4<Future<T1>,Future<T2>,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)

Type Parameters:

T1 -

T2 -

R -

Parameters:

cf1 -

cf2 -

zipFunctionForGet -

zipFunctionTimeoutGet -

Returns:

compose

public static <T1,T2,T3,R> ContinuableFuture<R> compose(Future<T1> cf1,
                                                        Future<T2> cf2,
                                                        Future<T3> cf3,
                                                        Throwables.TriFunction<? super Future<T1>,? super Future<T2>,? super Future<T3>,R,Exception> zipFunctionForGet)

Type Parameters:

T1 -

T2 -

T3 -

R -

Parameters:

cf1 -

cf2 -

cf3 -

zipFunctionForGet -

Returns:

compose

public static <T1,T2,T3,R> ContinuableFuture<R> compose(Future<T1> cf1,
                                                        Future<T2> cf2,
                                                        Future<T3> cf3,
                                                        Throwables.TriFunction<? super Future<T1>,? super Future<T2>,? super Future<T3>,R,Exception> zipFunctionForGet,
                                                        Throwables.Function<? super Tuple.Tuple5<Future<T1>,Future<T2>,Future<T3>,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)

Type Parameters:

T1 -

T2 -

T3 -

R -

Parameters:

cf1 -

cf2 -

cf3 -

zipFunctionForGet -

zipFunctionTimeoutGet -

Returns:

compose

public static <T,FC extends Collection<? extends Future<? extends T>>,R> ContinuableFuture<R> compose(FC cfs,
                                                                                                      Throwables.Function<? super FC,R,Exception> zipFunctionForGet)

Type Parameters:

T -

FC -

R -

Parameters:

cfs -

zipFunctionForGet -

Returns:

compose

public static <T,FC extends Collection<? extends Future<? extends T>>,R> ContinuableFuture<R> compose(FC cfs,
                                                                                                      Throwables.Function<? super FC,R,Exception> zipFunctionForGet,
                                                                                                      Throwables.Function<? super Tuple.Tuple3<FC,Long,TimeUnit>,R,Exception> zipFunctionTimeoutGet)

Type Parameters:

T -

FC -

R -

Parameters:

cfs -

zipFunctionForGet -

zipFunctionTimeoutGet -

Returns:

combine

public static <T1,T2,E extends Exception> ContinuableFuture<Tuple.Tuple2<T1,T2>> combine(Future<? extends T1> cf1,
                                                                                         Future<? extends T2> cf2)

Type Parameters:

T1 -

T2 -

E -

Parameters:

cf1 -

cf2 -

Returns:

combine

public static <T1,T2,T3,E extends Exception> ContinuableFuture<Tuple.Tuple3<T1,T2,T3>> combine(Future<? extends T1> cf1,
                                                                                               Future<? extends T2> cf2,
                                                                                               Future<? extends T3> cf3)

Type Parameters:

T1 -

T2 -

T3 -

E -

Parameters:

cf1 -

cf2 -

cf3 -

Returns:

combine

public static <T1,T2,T3,T4,E extends Exception> ContinuableFuture<Tuple.Tuple4<T1,T2,T3,T4>> combine(Future<? extends T1> cf1,
                                                                                                     Future<? extends T2> cf2,
                                                                                                     Future<? extends T3> cf3,
                                                                                                     Future<? extends T4> cf4)

Type Parameters:

T1 -

T2 -

T3 -

T4 -

E -

Parameters:

cf1 -

cf2 -

cf3 -

cf4 -

Returns:

combine

public static <T1,T2,T3,T4,T5,E extends Exception> ContinuableFuture<Tuple.Tuple5<T1,T2,T3,T4,T5>> combine(Future<? extends T1> cf1,
                                                                                                           Future<? extends T2> cf2,
                                                                                                           Future<? extends T3> cf3,
                                                                                                           Future<? extends T4> cf4,
                                                                                                           Future<? extends T5> cf5)

Type Parameters:

T1 -

T2 -

T3 -

T4 -

T5 -

E -

Parameters:

cf1 -

cf2 -

cf3 -

cf4 -

cf5 -

Returns:

combine

public static <T1,T2,T3,T4,T5,T6,E extends Exception> ContinuableFuture<Tuple.Tuple6<T1,T2,T3,T4,T5,T6>> combine(Future<? extends T1> cf1,
                                                                                                                 Future<? extends T2> cf2,
                                                                                                                 Future<? extends T3> cf3,
                                                                                                                 Future<? extends T4> cf4,
                                                                                                                 Future<? extends T5> cf5,
                                                                                                                 Future<? extends T6> cf6)

Type Parameters:

T1 -

T2 -

T3 -

T4 -

T5 -

T6 -

E -

Parameters:

cf1 -

cf2 -

cf3 -

cf4 -

cf5 -

cf6 -

Returns:

combine

public static <T1,T2,T3,T4,T5,T6,T7,E extends Exception> ContinuableFuture<Tuple.Tuple7<T1,T2,T3,T4,T5,T6,T7>> combine(Future<? extends T1> cf1,
                                                                                                                       Future<? extends T2> cf2,
                                                                                                                       Future<? extends T3> cf3,
                                                                                                                       Future<? extends T4> cf4,
                                                                                                                       Future<? extends T5> cf5,
                                                                                                                       Future<? extends T6> cf6,
                                                                                                                       Future<? extends T7> cf7)

Type Parameters:

T1 -

T2 -

T3 -

T4 -

T5 -

T6 -

T7 -

E -

Parameters:

cf1 -

cf2 -

cf3 -

cf4 -

cf5 -

cf6 -

cf7 -

Returns:

combine

public static <T1,T2,R,E extends Exception> ContinuableFuture<R> combine(Future<? extends T1> cf1,
                                                                         Future<? extends T2> cf2,
                                                                         Throwables.BiFunction<? super T1,? super T2,R,E> action)

Type Parameters:

T1 -

T2 -

R -

E -

Parameters:

cf1 -

cf2 -

action -

Returns:

combine

public static <T1,T2,T3,R,E extends Exception> ContinuableFuture<R> combine(Future<? extends T1> cf1,
                                                                            Future<? extends T2> cf2,
                                                                            Future<? extends T3> cf3,
                                                                            Throwables.TriFunction<? super T1,? super T2,? super T3,R,E> action)

Type Parameters:

T1 -

T2 -

T3 -

R -

E -

Parameters:

cf1 -

cf2 -

cf3 -

action -

Returns:

combine

public static <T,R,E extends Exception> ContinuableFuture<R> combine(Collection<? extends Future<? extends T>> cfs,
                                                                     Throwables.Function<List<T>,R,E> action)

Type Parameters:

T -

R -

E -

Parameters:

cfs -

action -

Returns:

allOf

@SafeVarargs
public static <T> ContinuableFuture<List<T>> allOf(Future<? extends T>... cfs)

Returns a new Future that is completed when all of the given Futures complete. If any of the given Futures complete exceptionally, then the returned Future also does so.

Type Parameters:

T -

Parameters:

cfs -

Returns:

allOf

public static <T> ContinuableFuture<List<T>> allOf(Collection<? extends Future<? extends T>> cfs)

Returns a new Future that is completed when all of the given Futures complete. If any of the given Futures complete exceptionally, then the returned Future also does so.

Type Parameters:

T -

Parameters:

cfs -

Returns:

anyOf

@SafeVarargs
public static <T> ContinuableFuture<T> anyOf(Future<? extends T>... cfs)

Returns a new Future that, when any of the given Futures complete normally. If all of the given Futures complete exceptionally, then the returned Future also does so.

Type Parameters:

T -

Parameters:

cfs -

Returns:

anyOf

public static <T> ContinuableFuture<T> anyOf(Collection<? extends Future<? extends T>> cfs)

Returns a new Future that, when any of the given Futures complete normally. If all of the given Futures complete exceptionally, then the returned Future also does so.

Type Parameters:

T -

Parameters:

cfs -

Returns:

iterate

@SafeVarargs
public static <T> ObjIterator<T> iterate(Future<? extends T>... cfs)

Type Parameters:

T -

Parameters:

cfs -

Returns:

iterate

public static <T> ObjIterator<T> iterate(Collection<? extends Future<? extends T>> cfs)

Type Parameters:

T -

Parameters:

cfs -

Returns:

iterate

public static <T> ObjIterator<T> iterate(Collection<? extends Future<? extends T>> cfs,
                                         long totalTimeoutForAll,
                                         TimeUnit unit)

Type Parameters:

T -

Parameters:

cfs -

totalTimeoutForAll -

unit -

Returns:

See Also:

ExecutorCompletionService}

iteratte

@SafeVarargs
public static <T> ObjIterator<Pair<T,Exception>> iteratte(Future<? extends T>... cfs)

Type Parameters:

T -

Parameters:

cfs -

Returns:

iteratte

public static <T> ObjIterator<Pair<T,Exception>> iteratte(Collection<? extends Future<? extends T>> cfs)

Type Parameters:

T -

Parameters:

cfs -

Returns:

iteratte

public static <T> ObjIterator<Pair<T,Exception>> iteratte(Collection<? extends Future<? extends T>> cfs,
                                                          long totalTimeoutForAll,
                                                          TimeUnit unit)

Type Parameters:

T -

Parameters:

cfs -

totalTimeoutForAll -

unit -

Returns:

See Also:

ExecutorCompletionService}