com.landawn.abacus.util

Class CompletableFuture<T>

java.lang.Object

com.landawn.abacus.util.CompletableFuture<T>

All Implemented Interfaces:

java.util.concurrent.Future<T>

public class CompletableFuture<T>
extends java.lang.Object
implements java.util.concurrent.Future<T>

Since:

0.8

Author:

Haiyang Li

See Also:

https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html

Method Summary

Modifier and Type	Method and Description
<U> CompletableFuture<U>	callAfterBoth(CompletableFuture<?> other, Try.Callable<U,java.lang.RuntimeException> action)
<U,R> CompletableFuture<R>	callAfterBoth(CompletableFuture<U> other, BiFunction<T,U,R> action)
<U,R> CompletableFuture<R>	callAfterBoth(CompletableFuture<U> other, Function<Tuple.Tuple4<T,java.lang.Throwable,U,java.lang.Throwable>,R> action)
<U> CompletableFuture<U>	callAfterEither(CompletableFuture<?> other, Try.Callable<U,java.lang.RuntimeException> action)
<R> CompletableFuture<R>	callAfterEither(CompletableFuture<? extends T> other, BiFunction<? super T,java.lang.Throwable,R> action)
<R> CompletableFuture<R>	callAfterEither(CompletableFuture<? extends T> other, Function<? super T,R> action)
boolean	cancel(boolean mayInterruptIfRunning)
boolean	cancelAll(boolean mayInterruptIfRunning) Cancel this future and all the previous stage future recursively.
static <T> CompletableFuture<T>	completed(T result)
CompletableFuture<T>	delayed(long delay, java.util.concurrent.TimeUnit unit)
T	get()
<U> U	get(BiFunction<? super T,java.lang.Throwable,? extends U> action)
<U> U	get(Function<? super T,? extends U> action)
T	get(long timeout, java.util.concurrent.TimeUnit unit)
<U> U	get(long timeout, java.util.concurrent.TimeUnit unit, BiFunction<? super T,java.lang.Throwable,? extends U> action)
<U> U	get(long timeout, java.util.concurrent.TimeUnit unit, Function<? super T,? extends U> action)
Pair<T,java.lang.Throwable>	get2()
Pair<T,java.lang.Throwable>	get2(long timeout, java.util.concurrent.TimeUnit unit)
T	getNow(T defaultValue)
boolean	isAllCancelled() Returns true if this future and all previous stage futures have been recursively cancelled, otherwise false is returned.
boolean	isCancelled()
boolean	isDone()
static CompletableFuture<java.lang.Void>	run(java.lang.Runnable action)
static CompletableFuture<java.lang.Void>	run(java.lang.Runnable action, java.util.concurrent.Executor executor)
static <T> CompletableFuture<T>	run(Try.Callable<T,java.lang.RuntimeException> action)
static <T> CompletableFuture<T>	run(Try.Callable<T,java.lang.RuntimeException> action, java.util.concurrent.Executor executor)
CompletableFuture<java.lang.Void>	runAfterBoth(CompletableFuture<?> other, java.lang.Runnable action)
<U> CompletableFuture<java.lang.Void>	runAfterBoth(CompletableFuture<U> other, BiConsumer<T,U> action)
<U> CompletableFuture<java.lang.Void>	runAfterBoth(CompletableFuture<U> other, Consumer<Tuple.Tuple4<T,java.lang.Throwable,U,java.lang.Throwable>> action)
CompletableFuture<java.lang.Void>	runAfterEither(CompletableFuture<?> other, java.lang.Runnable action)
CompletableFuture<java.lang.Void>	runAfterEither(CompletableFuture<? extends T> other, BiConsumer<? super T,java.lang.Throwable> action)
CompletableFuture<java.lang.Void>	runAfterEither(CompletableFuture<? extends T> other, Consumer<? super T> action)
<R> CompletableFuture<R>	thenCall(BiFunction<? super T,java.lang.Throwable,R> action)
<R> CompletableFuture<R>	thenCall(Function<? super T,R> action)
<U> CompletableFuture<U>	thenCall(Try.Callable<U,java.lang.RuntimeException> action)
CompletableFuture<java.lang.Void>	thenRun(BiConsumer<? super T,java.lang.Throwable> action)
CompletableFuture<java.lang.Void>	thenRun(Consumer<? super T> action)
CompletableFuture<java.lang.Void>	thenRun(java.lang.Runnable action)
CompletableFuture<T>	with(java.util.concurrent.Executor executor)
CompletableFuture<T>	with(java.util.concurrent.Executor executor, long delay, java.util.concurrent.TimeUnit unit)

Methods inherited from class java.lang.Object

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

Method Detail

run

public static CompletableFuture<java.lang.Void> run(java.lang.Runnable action)

run

public static <T> CompletableFuture<T> run(Try.Callable<T,java.lang.RuntimeException> action)

run

public static CompletableFuture<java.lang.Void> run(java.lang.Runnable action,
                                                    java.util.concurrent.Executor executor)

run

public static <T> CompletableFuture<T> run(Try.Callable<T,java.lang.RuntimeException> action,
                                           java.util.concurrent.Executor executor)

completed

public static <T> CompletableFuture<T> completed(T result)

Parameters:

result -

asyncExecutor -

Returns:

a CompletableFuture which is already done by passing the result to it directly.

cancel

public boolean cancel(boolean mayInterruptIfRunning)

Specified by:

cancel in interface java.util.concurrent.Future<T>

isCancelled

public boolean isCancelled()

Specified by:

isCancelled in interface java.util.concurrent.Future<T>

cancelAll

public boolean cancelAll(boolean mayInterruptIfRunning)

Cancel this future and all the previous stage future recursively.

Parameters:

mayInterruptIfRunning -

Returns:

isAllCancelled

public boolean isAllCancelled()

Returns true if this future and all previous stage futures have been recursively cancelled, otherwise false is returned.

Returns:

isDone

public boolean isDone()

Specified by:

isDone in interface java.util.concurrent.Future<T>

get

public T get()
      throws java.lang.InterruptedException,
             java.util.concurrent.ExecutionException

Specified by:

get in interface java.util.concurrent.Future<T>

Throws:

java.lang.InterruptedException

java.util.concurrent.ExecutionException

get

public T get(long timeout,
             java.util.concurrent.TimeUnit unit)
      throws java.lang.InterruptedException,
             java.util.concurrent.ExecutionException,
             java.util.concurrent.TimeoutException

Specified by:

get in interface java.util.concurrent.Future<T>

Throws:

java.lang.InterruptedException

java.util.concurrent.ExecutionException

java.util.concurrent.TimeoutException

get2

public Pair<T,java.lang.Throwable> get2()

get2

public Pair<T,java.lang.Throwable> get2(long timeout,
                                        java.util.concurrent.TimeUnit unit)

getNow

public T getNow(T defaultValue)

get

public <U> U get(Function<? super T,? extends U> action)

get

public <U> U get(long timeout,
                 java.util.concurrent.TimeUnit unit,
                 Function<? super T,? extends U> action)

get

public <U> U get(BiFunction<? super T,java.lang.Throwable,? extends U> action)

get

public <U> U get(long timeout,
                 java.util.concurrent.TimeUnit unit,
                 BiFunction<? super T,java.lang.Throwable,? extends U> action)

thenRun

public CompletableFuture<java.lang.Void> thenRun(java.lang.Runnable action)

thenRun

public CompletableFuture<java.lang.Void> thenRun(Consumer<? super T> action)

thenRun

public CompletableFuture<java.lang.Void> thenRun(BiConsumer<? super T,java.lang.Throwable> action)

thenCall

public <U> CompletableFuture<U> thenCall(Try.Callable<U,java.lang.RuntimeException> action)

thenCall

public <R> CompletableFuture<R> thenCall(Function<? super T,R> action)

thenCall

public <R> CompletableFuture<R> thenCall(BiFunction<? super T,java.lang.Throwable,R> action)

runAfterBoth

public CompletableFuture<java.lang.Void> runAfterBoth(CompletableFuture<?> other,
                                                      java.lang.Runnable action)

runAfterBoth

public <U> CompletableFuture<java.lang.Void> runAfterBoth(CompletableFuture<U> other,
                                                          BiConsumer<T,U> action)

runAfterBoth

public <U> CompletableFuture<java.lang.Void> runAfterBoth(CompletableFuture<U> other,
                                                          Consumer<Tuple.Tuple4<T,java.lang.Throwable,U,java.lang.Throwable>> action)

callAfterBoth

public <U> CompletableFuture<U> callAfterBoth(CompletableFuture<?> other,
                                              Try.Callable<U,java.lang.RuntimeException> action)

callAfterBoth

public <U,R> CompletableFuture<R> callAfterBoth(CompletableFuture<U> other,
                                                BiFunction<T,U,R> action)

callAfterBoth

public <U,R> CompletableFuture<R> callAfterBoth(CompletableFuture<U> other,
                                                Function<Tuple.Tuple4<T,java.lang.Throwable,U,java.lang.Throwable>,R> action)

runAfterEither

public CompletableFuture<java.lang.Void> runAfterEither(CompletableFuture<?> other,
                                                        java.lang.Runnable action)

runAfterEither

public CompletableFuture<java.lang.Void> runAfterEither(CompletableFuture<? extends T> other,
                                                        Consumer<? super T> action)

runAfterEither

public CompletableFuture<java.lang.Void> runAfterEither(CompletableFuture<? extends T> other,
                                                        BiConsumer<? super T,java.lang.Throwable> action)

callAfterEither

public <U> CompletableFuture<U> callAfterEither(CompletableFuture<?> other,
                                                Try.Callable<U,java.lang.RuntimeException> action)

callAfterEither

public <R> CompletableFuture<R> callAfterEither(CompletableFuture<? extends T> other,
                                                Function<? super T,R> action)

callAfterEither

public <R> CompletableFuture<R> callAfterEither(CompletableFuture<? extends T> other,
                                                BiFunction<? super T,java.lang.Throwable,R> action)

delayed

public CompletableFuture<T> delayed(long delay,
                                    java.util.concurrent.TimeUnit unit)

with

public CompletableFuture<T> with(java.util.concurrent.Executor executor)

with

public CompletableFuture<T> with(java.util.concurrent.Executor executor,
                                 long delay,
                                 java.util.concurrent.TimeUnit unit)