Package com.landawn.abacus.util

Class ContinuableFuture<T>

java.lang.Object

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

Type Parameters:

T -

All Implemented Interfaces:

Future<T>

public class ContinuableFuture<T>
extends Object
implements Future<T>

Since:

0.8

Author:

Haiyang Li

See Also:

• https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ContinuableFuture.html
• Futures

Method Summary

Modifier and Type	Method	Description
static <T> ContinuableFuture<T>	call(Callable<T> action)
static <T> ContinuableFuture<T>	call(Callable<T> action, Executor executor)
<R> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<?> other, Callable<R> action)	Call after both.
<U, R> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.BiFunction<? super T,? super U,? extends R,? extends Exception> action)	Call after both.
<U, R> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.Function<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,? extends R,? extends Exception> action)	Call after both.
<U, R> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.QuadFunction<T,? super Exception,U,? super Exception,? extends R,? extends Exception> action)	Call after both.
<R> ContinuableFuture<R>	callAfterEither(ContinuableFuture<?> other, Callable<R> action)	Call after either.
<R> ContinuableFuture<R>	callAfterEither(ContinuableFuture<? extends T> other, Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)	Call after either.
<R> ContinuableFuture<R>	callAfterEither(ContinuableFuture<? extends T> other, Throwables.Function<? super T,? extends R,? extends Exception> action)	Call after either.
<R> ContinuableFuture<R>	callAfterFirstSucceed(ContinuableFuture<?> other, Callable<R> action)	Call after either.
<R> ContinuableFuture<R>	callAfterFirstSucceed(ContinuableFuture<? extends T> other, Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)	Call after either.
<R> ContinuableFuture<R>	callAfterFirstSucceed(ContinuableFuture<? extends T> other, Throwables.Function<? super T,? extends R,? extends Exception> action)	Call after either.
boolean	cancel(boolean mayInterruptIfRunning)
boolean	cancelAll(boolean mayInterruptIfRunning)	Cancel this future and all the previous stage future recursively.
static <T> ContinuableFuture<T>	completed(T result)
T	get()
T	get(long timeout, TimeUnit unit)
T	getNow(T defaultValue)	Gets the now.
Result<T,Exception>	gett()	Gets the t.
Result<T,Exception>	gett(long timeout, TimeUnit unit)	Gets the t.
<E extends Exception> void	getThenAccept(long timeout, TimeUnit unit, Throwables.BiConsumer<? super T,? super Exception,E> action)	Gets the then accept.
<E extends Exception> void	getThenAccept(long timeout, TimeUnit unit, Throwables.Consumer<? super T,E> action)	Gets the then accept.
<E extends Exception> void	getThenAccept(Throwables.BiConsumer<? super T,? super Exception,E> action)	Gets the then accept.
<E extends Exception> void	getThenAccept(Throwables.Consumer<? super T,E> action)	Gets the then accept.
<U, E extends Exception> U	getThenApply(long timeout, TimeUnit unit, Throwables.BiFunction<? super T,? super Exception,U,E> action)	Gets the then apply.
<U, E extends Exception> U	getThenApply(long timeout, TimeUnit unit, Throwables.Function<? super T,U,E> action)	Gets the then apply.
<U, E extends Exception> U	getThenApply(Throwables.BiFunction<? super T,? super Exception,U,E> action)	Gets the then apply.
<U, E extends Exception> U	getThenApply(Throwables.Function<? super T,U,E> action)	Gets the then apply.
boolean	isAllCancelled()	Returns true if this future and all previous stage futures have been recursively cancelled, otherwise false is returned.
boolean	isCancelled()	Checks if is cancelled.
boolean	isDone()	Checks if is done.
<U> ContinuableFuture<U>	map(Throwables.Function<? super T,? extends U,? extends Exception> func)
static ContinuableFuture<Void>	run(Throwables.Runnable<? extends Exception> action)
static ContinuableFuture<Void>	run(Throwables.Runnable<? extends Exception> action, Executor executor)
ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<?> other, Throwables.Runnable<? extends Exception> action)	Run after both.
<U> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.BiConsumer<? super T,? super U,? extends Exception> action)	Run after both.
<U> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.Consumer<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,? extends Exception> action)	Run after both.
<U> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.QuadConsumer<T,? super Exception,U,? super Exception,? extends Exception> action)	Run after both.
ContinuableFuture<Void>	runAfterEither(ContinuableFuture<?> other, Throwables.Runnable<? extends Exception> action)	Run after either.
ContinuableFuture<Void>	runAfterEither(ContinuableFuture<? extends T> other, Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)	Run after either.
ContinuableFuture<Void>	runAfterEither(ContinuableFuture<? extends T> other, Throwables.Consumer<? super T,? extends Exception> action)	Run after either.
ContinuableFuture<Void>	runAfterFirstSucceed(ContinuableFuture<?> other, Throwables.Runnable<? extends Exception> action)	Run after either.
ContinuableFuture<Void>	runAfterFirstSucceed(ContinuableFuture<? extends T> other, Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)	Run after either.
ContinuableFuture<Void>	runAfterFirstSucceed(ContinuableFuture<? extends T> other, Throwables.Consumer<? super T,? extends Exception> action)	Run after either.
<R> ContinuableFuture<R>	thenCall(Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)
<R> ContinuableFuture<R>	thenCall(Throwables.Function<? super T,? extends R,? extends Exception> action)
<R> ContinuableFuture<R>	thenCall(Callable<R> action)
ContinuableFuture<T>	thenDelay(long delay, TimeUnit unit)
ContinuableFuture<Void>	thenRun(Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)
ContinuableFuture<Void>	thenRun(Throwables.Consumer<? super T,? extends Exception> action)
ContinuableFuture<Void>	thenRun(Throwables.Runnable<? extends Exception> action)
ContinuableFuture<T>	thenUse(Executor executor)
static <T> ContinuableFuture<T>	wrap(Future<T> future)

Methods inherited from class java.lang.Object

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

Method Details

run

public static ContinuableFuture<Void> run(Throwables.Runnable<? extends Exception> action)

Parameters:

action -

Returns:

See Also:

• N.asyncExecute(Throwables.Runnable)

run

public static ContinuableFuture<Void> run(Throwables.Runnable<? extends Exception> action,
 Executor executor)

Parameters:

action -

executor -

Returns:

call

public static <T> ContinuableFuture<T> call(Callable<T> action)

Type Parameters:

T -

Parameters:

action -

Returns:

See Also:

• N.asyncExecute(Callable)

call

public static <T> ContinuableFuture<T> call(Callable<T> action,
 Executor executor)

Type Parameters:

T -

Parameters:

action -

executor -

Returns:

completed

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

Type Parameters:

T -

Parameters:

result -

Returns:

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

wrap

public static <T> ContinuableFuture<T> wrap(Future<T> future)

Type Parameters:

T -

Parameters:

future -

Returns:

cancel

public boolean cancel(boolean mayInterruptIfRunning)

Specified by:

cancel in interface Future<T>

Parameters:

mayInterruptIfRunning -

Returns:

isCancelled

public boolean isCancelled()

Checks if is cancelled.

Specified by:

isCancelled in interface Future<T>

Returns:

true, if is cancelled

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:

true, if is all cancelled

isDone

public boolean isDone()

Checks if is done.

Specified by:

isDone in interface Future<T>

Returns:

true, if is done

get

public T get()
      throws InterruptedException,
ExecutionException

Specified by:

get in interface Future<T>

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

get

public T get(long timeout,
 TimeUnit unit)
      throws InterruptedException,
ExecutionException,
TimeoutException

Specified by:

get in interface Future<T>

Parameters:

timeout -

unit -

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

TimeoutException - the timeout exception

gett

public Result<T,Exception> gett()

Gets the t.

Returns:

gett

public Result<T,Exception> gett(long timeout,
 TimeUnit unit)

Gets the t.

Parameters:

timeout -

unit -

Returns:

getNow

public T getNow(T defaultValue)
         throws InterruptedException,
ExecutionException

Gets the now.

Parameters:

defaultValue -

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

getThenApply

public <U,
E extends Exception> U getThenApply(Throwables.Function<? super T,U,E> action)
                                       throws InterruptedException,
ExecutionException,
E

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

action -

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

E - the e

getThenApply

public <U,
E extends Exception> U getThenApply(long timeout,
 TimeUnit unit,
 Throwables.Function<? super T,U,E> action)
                                       throws InterruptedException,
ExecutionException,
TimeoutException,
E

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

timeout -

unit -

action -

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

TimeoutException - the timeout exception

E - the e

getThenApply

public <U,
E extends Exception> U getThenApply(Throwables.BiFunction<? super T,? super Exception,U,E> action)
                                       throws E

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

action -

Returns:

Throws:

E - the e

getThenApply

public <U,
E extends Exception> U getThenApply(long timeout,
 TimeUnit unit,
 Throwables.BiFunction<? super T,? super Exception,U,E> action)
                                       throws E

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

timeout -

unit -

action -

Returns:

Throws:

E - the e

getThenAccept

public <E extends Exception> void getThenAccept(Throwables.Consumer<? super T,E> action)
                                         throws InterruptedException,
ExecutionException,
E

Gets the then accept.

Type Parameters:

E -

Parameters:

action -

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

E - the e

getThenAccept

public <E extends Exception> void getThenAccept(long timeout,
 TimeUnit unit,
 Throwables.Consumer<? super T,E> action)
                                         throws InterruptedException,
ExecutionException,
TimeoutException,
E

Gets the then accept.

Type Parameters:

E -

Parameters:

timeout -

unit -

action -

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

TimeoutException - the timeout exception

E - the e

getThenAccept

public <E extends Exception> void getThenAccept(Throwables.BiConsumer<? super T,? super Exception,E> action)
                                         throws E

Gets the then accept.

Type Parameters:

E -

Parameters:

action -

Throws:

E - the e

getThenAccept

public <E extends Exception> void getThenAccept(long timeout,
 TimeUnit unit,
 Throwables.BiConsumer<? super T,? super Exception,E> action)
                                         throws E

Gets the then accept.

Type Parameters:

E -

Parameters:

timeout -

unit -

action -

Throws:

E - the e

map

public <U> ContinuableFuture<U> map(Throwables.Function<? super T,? extends U,? extends Exception> func)

Type Parameters:

U -

Parameters:

func -

Returns:

thenRun

public ContinuableFuture<Void> thenRun(Throwables.Runnable<? extends Exception> action)

Parameters:

action -

Returns:

thenRun

public ContinuableFuture<Void> thenRun(Throwables.Consumer<? super T,? extends Exception> action)

Parameters:

action -

Returns:

thenRun

public ContinuableFuture<Void> thenRun(Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)

Parameters:

action -

Returns:

thenCall

public <R> ContinuableFuture<R> thenCall(Callable<R> action)

Type Parameters:

R -

Parameters:

action -

Returns:

thenCall

public <R> ContinuableFuture<R> thenCall(Throwables.Function<? super T,? extends R,? extends Exception> action)

Type Parameters:

R -

Parameters:

action -

Returns:

thenCall

public <R> ContinuableFuture<R> thenCall(Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)

Type Parameters:

R -

Parameters:

action -

Returns:

runAfterBoth

public ContinuableFuture<Void> runAfterBoth(ContinuableFuture<?> other,
 Throwables.Runnable<? extends Exception> action)

Run after both.

Parameters:

other -

action -

Returns:

runAfterBoth

public <U> ContinuableFuture<Void> runAfterBoth(ContinuableFuture<U> other,
 Throwables.BiConsumer<? super T,? super U,? extends Exception> action)

Run after both.

Type Parameters:

U -

Parameters:

other -

action -

Returns:

runAfterBoth

public <U> ContinuableFuture<Void> runAfterBoth(ContinuableFuture<U> other,
 Throwables.Consumer<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,? extends Exception> action)

Run after both.

Type Parameters:

U -

Parameters:

other -

action -

Returns:

runAfterBoth

public <U> ContinuableFuture<Void> runAfterBoth(ContinuableFuture<U> other,
 Throwables.QuadConsumer<T,? super Exception,U,? super Exception,? extends Exception> action)

Run after both.

Type Parameters:

U -

Parameters:

other -

action -

Returns:

callAfterBoth

public <R> ContinuableFuture<R> callAfterBoth(ContinuableFuture<?> other,
 Callable<R> action)

Call after both.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

callAfterBoth

public <U,
R> ContinuableFuture<R> callAfterBoth(ContinuableFuture<U> other,
 Throwables.BiFunction<? super T,? super U,? extends R,? extends Exception> action)

Call after both.

Type Parameters:

U -

R -

Parameters:

other -

action -

Returns:

callAfterBoth

public <U,
R> ContinuableFuture<R> callAfterBoth(ContinuableFuture<U> other,
 Throwables.Function<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,? extends R,? extends Exception> action)

Call after both.

Type Parameters:

U -

R -

Parameters:

other -

action -

Returns:

callAfterBoth

public <U,
R> ContinuableFuture<R> callAfterBoth(ContinuableFuture<U> other,
 Throwables.QuadFunction<T,? super Exception,U,? super Exception,? extends R,? extends Exception> action)

Call after both.

Type Parameters:

U -

R -

Parameters:

other -

action -

Returns:

runAfterEither

public ContinuableFuture<Void> runAfterEither(ContinuableFuture<?> other,
 Throwables.Runnable<? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

runAfterEither

public ContinuableFuture<Void> runAfterEither(ContinuableFuture<? extends T> other,
 Throwables.Consumer<? super T,? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

runAfterEither

public ContinuableFuture<Void> runAfterEither(ContinuableFuture<? extends T> other,
 Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

callAfterEither

public <R> ContinuableFuture<R> callAfterEither(ContinuableFuture<?> other,
 Callable<R> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

callAfterEither

public <R> ContinuableFuture<R> callAfterEither(ContinuableFuture<? extends T> other,
 Throwables.Function<? super T,? extends R,? extends Exception> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

callAfterEither

public <R> ContinuableFuture<R> callAfterEither(ContinuableFuture<? extends T> other,
 Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

runAfterFirstSucceed

public ContinuableFuture<Void> runAfterFirstSucceed(ContinuableFuture<?> other,
 Throwables.Runnable<? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

runAfterFirstSucceed

public ContinuableFuture<Void> runAfterFirstSucceed(ContinuableFuture<? extends T> other,
 Throwables.Consumer<? super T,? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

runAfterFirstSucceed

public ContinuableFuture<Void> runAfterFirstSucceed(ContinuableFuture<? extends T> other,
 Throwables.BiConsumer<? super T,? super Exception,? extends Exception> action)

Run after either.

Parameters:

other -

action -

Returns:

callAfterFirstSucceed

public <R> ContinuableFuture<R> callAfterFirstSucceed(ContinuableFuture<?> other,
 Callable<R> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

callAfterFirstSucceed

public <R> ContinuableFuture<R> callAfterFirstSucceed(ContinuableFuture<? extends T> other,
 Throwables.Function<? super T,? extends R,? extends Exception> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

callAfterFirstSucceed

public <R> ContinuableFuture<R> callAfterFirstSucceed(ContinuableFuture<? extends T> other,
 Throwables.BiFunction<? super T,? super Exception,? extends R,? extends Exception> action)

Call after either.

Type Parameters:

R -

Parameters:

other -

action -

Returns:

thenDelay

public ContinuableFuture<T> thenDelay(long delay,
 TimeUnit unit)

Parameters:

delay -

unit -

Returns:

thenUse

public ContinuableFuture<T> thenUse(Executor executor)

Parameters:

executor -

Returns: