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 and 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,E extends Exception> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.BiFunction<? super T,? super U,R,E> action) Call after both.
<U,R,E extends Exception> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.Function<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,R,E> action) Call after both.
<U,R,E extends Exception> ContinuableFuture<R>	callAfterBoth(ContinuableFuture<U> other, Throwables.QuadFunction<T,? super Exception,U,? super Exception,R,E> action) Call after both.
<R> ContinuableFuture<R>	callAfterEither(ContinuableFuture<?> other, Callable<R> action) Call after either.
<R,E extends Exception> ContinuableFuture<R>	callAfterEither(ContinuableFuture<? extends T> other, Throwables.BiFunction<? super T,? super Exception,R,E> action) Call after either.
<R,E extends Exception> ContinuableFuture<R>	callAfterEither(ContinuableFuture<? extends T> other, Throwables.Function<? super T,R,E> 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,E extends Exception> ContinuableFuture<U>	map(Throwables.Function<? super T,U,E> func)
static <E extends Exception> ContinuableFuture<Void>	run(Throwables.Runnable<E> action)
static <E extends Exception> ContinuableFuture<Void>	run(Throwables.Runnable<E> action, Executor executor)
<E extends Exception> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<?> other, Throwables.Runnable<E> action) Run after both.
<U,E extends Exception> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.BiConsumer<? super T,? super U,E> action) Run after both.
<U,E extends Exception> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.Consumer<? super Tuple.Tuple4<T,? super Exception,U,? super Exception>,E> action) Run after both.
<U,E extends Exception> ContinuableFuture<Void>	runAfterBoth(ContinuableFuture<U> other, Throwables.QuadConsumer<T,? super Exception,U,? super Exception,E> action) Run after both.
<E extends Exception> ContinuableFuture<Void>	runAfterEither(ContinuableFuture<?> other, Throwables.Runnable<E> action) Run after either.
<E extends Exception> ContinuableFuture<Void>	runAfterEither(ContinuableFuture<? extends T> other, Throwables.BiConsumer<? super T,? super Exception,E> action) Run after either.
<E extends Exception> ContinuableFuture<Void>	runAfterEither(ContinuableFuture<? extends T> other, Throwables.Consumer<? super T,E> action) Run after either.
<R> ContinuableFuture<R>	thenCall(Callable<R> action)
<R,E extends Exception> ContinuableFuture<R>	thenCall(Throwables.BiFunction<? super T,? super Exception,R,E> action)
<R,E extends Exception> ContinuableFuture<R>	thenCall(Throwables.Function<? super T,R,E> action)
ContinuableFuture<T>	thenDelay(long delay, TimeUnit unit)
<E extends Exception> ContinuableFuture<Void>	thenRun(Throwables.BiConsumer<? super T,? super Exception,E> action)
<E extends Exception> ContinuableFuture<Void>	thenRun(Throwables.Consumer<? super T,E> action)
<E extends Exception> ContinuableFuture<Void>	thenRun(Throwables.Runnable<E> 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 Detail

run

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

Type Parameters:

E -

Parameters:

action -

Returns:

See Also:

N.asyncExecute(com.landawn.abacus.util.Throwables.Runnable)

run

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

Type Parameters:

E -

Parameters:

action -

executor -

Returns:

call

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

Type Parameters:

T -

E -

Parameters:

action -

Returns:

See Also:

N.asyncExecute(Callable)

call

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

Type Parameters:

T -

E -

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)

Gets the now.

Parameters:

defaultValue -

Returns:

getThenApply

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

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

action -

Returns:

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

E - the e

E extends Exception

getThenApply

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

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

E extends Exception

getThenApply

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

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

action -

Returns:

Throws:

E - the e

E extends Exception

getThenApply

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

Gets the then apply.

Type Parameters:

U -

E -

Parameters:

timeout -

unit -

action -

Returns:

Throws:

E - the e

E extends Exception

getThenAccept

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

Gets the then accept.

Type Parameters:

E -

Parameters:

action -

Throws:

InterruptedException - the interrupted exception

ExecutionException - the execution exception

E - the e

E extends Exception

getThenAccept

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

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

E extends Exception

getThenAccept

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

Gets the then accept.

Type Parameters:

E -

Parameters:

action -

Throws:

E - the e

E extends Exception

getThenAccept

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

Gets the then accept.

Type Parameters:

E -

Parameters:

timeout -

unit -

action -

Throws:

E - the e

E extends Exception

map

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

Type Parameters:

U -

E -

Parameters:

func -

Returns:

thenRun

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

Type Parameters:

E -

Parameters:

action -

Returns:

thenRun

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

Type Parameters:

E -

Parameters:

action -

Returns:

thenRun

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

Type Parameters:

E -

Parameters:

action -

Returns:

thenCall

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

Type Parameters:

R -

E -

Parameters:

action -

Returns:

thenCall

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

Type Parameters:

R -

E -

Parameters:

action -

Returns:

thenCall

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

Type Parameters:

R -

E -

Parameters:

action -

Returns:

runAfterBoth

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

Run after both.

Type Parameters:

E -

Parameters:

other -

action -

Returns:

runAfterBoth

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

Run after both.

Type Parameters:

U -

E -

Parameters:

other -

action -

Returns:

runAfterBoth

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

Run after both.

Type Parameters:

U -

E -

Parameters:

other -

action -

Returns:

runAfterBoth

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

Run after both.

Type Parameters:

U -

E -

Parameters:

other -

action -

Returns:

callAfterBoth

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

Call after both.

Type Parameters:

R -

E -

Parameters:

other -

action -

Returns:

callAfterBoth

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

Call after both.

Type Parameters:

U -

R -

E -

Parameters:

other -

action -

Returns:

callAfterBoth

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

Call after both.

Type Parameters:

U -

R -

E -

Parameters:

other -

action -

Returns:

callAfterBoth

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

Call after both.

Type Parameters:

U -

R -

E -

Parameters:

other -

action -

Returns:

runAfterEither

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

Run after either.

Type Parameters:

E -

Parameters:

other -

action -

Returns:

runAfterEither

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

Run after either.

Type Parameters:

E -

Parameters:

other -

action -

Returns:

runAfterEither

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

Run after either.

Type Parameters:

E -

Parameters:

other -

action -

Returns:

callAfterEither

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

Call after either.

Type Parameters:

R -

E -

Parameters:

other -

action -

Returns:

callAfterEither

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

Call after either.

Type Parameters:

R -

E -

Parameters:

other -

action -

Returns:

callAfterEither

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

Call after either.

Type Parameters:

R -

E -

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: