Package io.foldright.cffu

Class CffuFactory

java.lang.Object

io.foldright.cffu.CffuFactory

@ThreadSafe
@ParametersAreNonnullByDefault
@ReturnValuesAreNonnullByDefault
public final class CffuFactory
extends Object

This class CffuFactory is equivalent to CompletableFuture, contains the static (factory) methods of CompletableFuture.

The methods that equivalent to the instance methods of CompletableFuture is in Cffu class.

Use builder(Executor) to config and build CffuFactory.

About factory methods conventions of CffuFactory:

• factory methods return Cffu instead of CompletableFuture.
• only provide varargs methods for multiply Cffu/CF input arguments; if you have List input, use static util methods cffuListToArray(List) or CompletableFutureUtils.completableFutureListToArray(List) to convert it to array first.

Author:

Jerry Lee (oldratlee at gmail dot com)

See Also:

• Cffu
• CompletableFuture

Method Summary

Modifier and Type	Method	Description
Cffu<Void>	allOf(CompletionStage<?>... cfs)	Returns a new Cffu that is completed when all the given stages complete.
Cffu<Void>	allOfFastFail(CompletionStage<?>... cfs)	Returns a new Cffu that is successful when all the given stages success, the results(Cffu<Void>) of the given stages are not reflected in the returned Cffu, but may be obtained by inspecting them individually.
final <T> Cffu<List<T>>	allResultsOf(CompletionStage<? extends T>... cfs)	Returns a new Cffu with the results in the same order of all the given stages, the new Cffu is completed when all the given stages complete.
final <T> Cffu<List<T>>	allResultsOfFastFail(CompletionStage<? extends T>... cfs)	Returns a new Cffu with the results in the same order of all the given stages, the new Cffu success when all the given stages success.
<T1, T2> Cffu<Tuple2<T1,T2>>	allTupleOf(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2)	Returns a new Cffu that is completed when the given two CompletableFutures complete.
<T1, T2, T3> Cffu<Tuple3<T1,T2,T3>>	allTupleOf(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3)	Returns a new Cffu that is completed when the given three CompletableFutures complete.
<T1, T2, T3, T4> Cffu<Tuple4<T1,T2,T3,T4>>	allTupleOf(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3, CompletionStage<? extends T4> cf4)	Returns a new Cffu that is completed when the given 4 CompletableFutures complete.
<T1, T2, T3, T4, T5> Cffu<Tuple5<T1,T2,T3,T4,T5>>	allTupleOf(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3, CompletionStage<? extends T4> cf4, CompletionStage<? extends T5> cf5)	Returns a new Cffu that is completed when the given 5 CompletableFutures complete.
<T1, T2> Cffu<Tuple2<T1,T2>>	allTupleOfFastFail(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2)	Returns a new Cffu that is successful when the given two CompletableFutures success.
<T1, T2, T3> Cffu<Tuple3<T1,T2,T3>>	allTupleOfFastFail(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3)	Returns a new Cffu that is successful when the given three CompletableFutures success.
<T1, T2, T3, T4> Cffu<Tuple4<T1,T2,T3,T4>>	allTupleOfFastFail(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3, CompletionStage<? extends T4> cf4)	Returns a new Cffu that is successful when the given four CompletableFutures success.
<T1, T2, T3, T4, T5> Cffu<Tuple5<T1,T2,T3,T4,T5>>	allTupleOfFastFail(CompletionStage<? extends T1> cf1, CompletionStage<? extends T2> cf2, CompletionStage<? extends T3> cf3, CompletionStage<? extends T4> cf4, CompletionStage<? extends T5> cf5)	Returns a new Cffu that is successful when the given five CompletableFutures success.
final <T> Cffu<T>	anyOf(CompletionStage<? extends T>... cfs)	Returns a new Cffu that is completed when any of the given stages complete, with the same result. Otherwise, if it completed exceptionally, the returned Cffu also does so, with a CompletionException holding this exception as its cause. If no stages are provided, returns an incomplete Cffu.
final <T> Cffu<T>	anyOfSuccess(CompletionStage<? extends T>... cfs)	Returns a new Cffu that is successful when any of the given stages success, with the same result.
static CffuFactoryBuilder	builder(Executor defaultExecutor)	Returns a CffuFactoryBuilder with defaultExecutor setting.
static <T> CompletableFuture<T>[]	cffuArrayUnwrap(Cffu<T>... cfs)	A convenient util method for unwrap input Cffu array elements by Cffu.cffuUnwrap().
static <T> Cffu<T>[]	cffuListToArray(List<Cffu<T>> cffuList)	Convert Cffu list to Cffu array.
<T> Cffu<T>	completedFuture(T value)	Returns a new Cffu that is already completed with the given value.
<T> CompletionStage<T>	completedStage(T value)	Returns a new CompletionStage that is already completed with the given value and supports only those methods in interface CompletionStage.
Executor	defaultExecutor()	Returns the default Executor used for async methods that do not specify an Executor.
Executor	delayedExecutor(long delay, TimeUnit unit)	Returns a new Executor that submits a task to the default executor after the given delay (or no delay if non-positive).
Executor	delayedExecutor(long delay, TimeUnit unit, Executor executor)	Returns a new Executor that submits a task to the given base executor after the given delay (or no delay if non-positive).
<T> Cffu<T>	failedFuture(Throwable ex)	Returns a new Cffu that is already completed exceptionally with the given exception.
<T> CompletionStage<T>	failedStage(Throwable ex)	Returns a new CompletionStage that is already completed exceptionally with the given exception and supports only those methods in interface CompletionStage.
boolean	forbidObtrudeMethods()	Returns forbidObtrudeMethods or not.
<T> Cffu<T>	newIncompleteCffu()	Return an incomplete Cffu, equivalent to CompletableFuture() constructor.
Cffu<Void>	runAsync(Runnable action)	Returns a new Cffu that is asynchronously completed by a task running in the defaultExecutor() after it runs the given action.
Cffu<Void>	runAsync(Runnable action, Executor executor)	Returns a new Cffu that is asynchronously completed by a task running in the given executor after it runs the given action.
<T> Cffu<T>	supplyAsync(Supplier<T> supplier)	Returns a new Cffu that is asynchronously completed by a task running in the defaultExecutor() with the value obtained by calling the given Supplier.
<T> Cffu<T>	supplyAsync(Supplier<T> supplier, Executor executor)	Returns a new Cffu that is asynchronously completed by a task running in the given executor with the value obtained by calling the given Supplier.
<T> Cffu<T>	toCffu(CompletionStage<T> stage)	Wrap an existed CompletableFuture / CompletionStage / Cffu to Cffu.
final <T> Cffu<T>[]	toCffuArray(CompletionStage<T>... stages)	A convenient util method for wrap input CompletableFuture / CompletionStage / Cffu array element by toCffu(CompletionStage).

Methods inherited from class java.lang.Object

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

Method Details

builder

@Contract(pure=true)
public static CffuFactoryBuilder builder(Executor defaultExecutor)

Returns a CffuFactoryBuilder with defaultExecutor setting.

See Also:

• Cffu.defaultExecutor()
• defaultExecutor()

completedFuture

@Contract(pure=true)
public <T> Cffu<T> completedFuture(@Nullable
 T value)

Returns a new Cffu that is already completed with the given value.

Type Parameters:

T - the type of the value

Parameters:

value - the value

Returns:

the completed Cffu

See Also:

• CompletableFuture.completedFuture(Object)

completedStage

@Contract(pure=true)
public <T> CompletionStage<T> completedStage(@Nullable
 T value)

Returns a new CompletionStage that is already completed with the given value and supports only those methods in interface CompletionStage.

CAUTION:
if run on old Java 8, just return a Cffu with a *normal* underlying CompletableFuture which is NOT with a *minimal* CompletionStage.

Type Parameters:

T - the type of the value

Parameters:

value - the value

Returns:

the completed CompletionStage

See Also:

• CompletableFuture.completedStage(Object)
• CompletableFuture.minimalCompletionStage()

failedFuture

@Contract(pure=true)
public <T> Cffu<T> failedFuture(Throwable ex)

Returns a new Cffu that is already completed exceptionally with the given exception.

Type Parameters:

T - the type of the value

Parameters:

ex - the exception

Returns:

the exceptionally completed Cffu

See Also:

• CompletableFuture.failedFuture(Throwable)

failedStage

@Contract(pure=true)
public <T> CompletionStage<T> failedStage(Throwable ex)

Returns a new CompletionStage that is already completed exceptionally with the given exception and supports only those methods in interface CompletionStage.

CAUTION:
if run on old Java 8, just return a Cffu with a *normal* underlying CompletableFuture which is NOT with a *minimal* CompletionStage.

Type Parameters:

T - the type of the value

Parameters:

ex - the exception

Returns:

the exceptionally completed CompletionStage

See Also:

• CompletableFuture.failedStage(Throwable)
• CompletableFuture.minimalCompletionStage()

runAsync

public Cffu<Void> runAsync(Runnable action)

Returns a new Cffu that is asynchronously completed by a task running in the defaultExecutor() after it runs the given action.

Parameters:

action - the action to run before completing the returned Cffu

Returns:

the new Cffu

See Also:

• CompletableFuture.runAsync(Runnable)

runAsync

public Cffu<Void> runAsync(Runnable action,
 Executor executor)

Returns a new Cffu that is asynchronously completed by a task running in the given executor after it runs the given action.

Parameters:

action - the action to run before completing the returned Cffu

executor - the executor to use for asynchronous execution

Returns:

the new Cffu

See Also:

• CompletableFuture.runAsync(Runnable, Executor)

supplyAsync

@CheckReturnValue(explanation="should use the returned Cffu; otherwise, prefer method `runAsync`")
public <T> Cffu<T> supplyAsync(Supplier<T> supplier)

Returns a new Cffu that is asynchronously completed by a task running in the defaultExecutor() with the value obtained by calling the given Supplier.

Type Parameters:

T - the function's return type

Parameters:

supplier - a function returning the value to be used to complete the returned Cffu

Returns:

the new Cffu

See Also:

• CompletableFuture.supplyAsync(Supplier)

supplyAsync

@CheckReturnValue(explanation="should use the returned Cffu; otherwise, prefer method `runAsync`")
public <T> Cffu<T> supplyAsync(Supplier<T> supplier,
 Executor executor)

Returns a new Cffu that is asynchronously completed by a task running in the given executor with the value obtained by calling the given Supplier.

Type Parameters:

T - the function's return type

Parameters:

supplier - a function returning the value to be used to complete the returned Cffu

executor - the executor to use for asynchronous execution

Returns:

the new Cffu

See Also:

• CompletableFuture.supplyAsync(Supplier, Executor)

newIncompleteCffu

@Contract(pure=true)
public <T> Cffu<T> newIncompleteCffu()

Return an incomplete Cffu, equivalent to CompletableFuture() constructor.

In general, should not use this method in biz code, prefer below factory methods of Cffu:

1. runAsync(Runnable)
2. supplyAsync(Supplier, Executor)

See Also:

• runAsync(Runnable)
• runAsync(Runnable, Executor)
• supplyAsync(Supplier)
• supplyAsync(Supplier, Executor)
• CompletableFuture()

toCffu

@Contract(pure=true)
public <T> Cffu<T> toCffu(CompletionStage<T> stage)

Wrap an existed CompletableFuture / CompletionStage / Cffu to Cffu. for CompletableFuture class instances, Cffu.cffuUnwrap() is the inverse operation to this method.

NOTE, keep input stage unchanged if possible when wrap:

1. if input stage is a Cffu, re-wrapped with the config of this CffuFactory by Cffu.resetCffuFactory(CffuFactory).
2. if input stage is a CompletableFuture, wrap it by setting it as the underlying cf of returned cffu.
3. otherwise use input stage.toCompletableFuture as the underlying cf of returned cffu.

Throws:

NullPointerException - if the given stage is null

See Also:

• toCffuArray(CompletionStage[])
• CompletionStage.toCompletableFuture()
• Cffu.cffuUnwrap()
• Cffu.resetCffuFactory(CffuFactory)

toCffuArray

@Contract(pure=true)
@SafeVarargs
public final <T> Cffu<T>[] toCffuArray(CompletionStage<T>... stages)

A convenient util method for wrap input CompletableFuture / CompletionStage / Cffu array element by toCffu(CompletionStage).

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• toCffu(CompletionStage)

allOf

@Contract(pure=true)
public Cffu<Void> allOf(CompletionStage<?>... cfs)

Returns a new Cffu that is completed when all the given stages complete. If any of the given stages complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause.
Otherwise, the results, if any, of the given stages are not reflected in the returned Cffu(Cffu<Void>), but may be obtained by inspecting them individually.
If no stages are provided, returns a Cffu completed with the value null.

if you need the results of given stages, prefer below methods:

1. allResultsOf(CompletionStage[])
2. allTupleOf(CompletionStage, CompletionStage) / allTupleOf(CompletionStage, CompletionStage, CompletionStage, CompletionStage, CompletionStage) (provided overloaded methods with 2~5 input)

Parameters:

cfs - the stages

Returns:

a new Cffu that is completed when all the given stages complete

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• allResultsOf(CompletionStage[])
• allTupleOf(CompletionStage, CompletionStage)
• allTupleOf(CompletionStage, CompletionStage, CompletionStage)
• allTupleOf(CompletionStage, CompletionStage, CompletionStage, CompletionStage)
• allTupleOf(CompletionStage, CompletionStage, CompletionStage, CompletionStage, CompletionStage)
• CompletableFutureUtils.allOf(CompletionStage[])

allOfFastFail

@Contract(pure=true)
public Cffu<Void> allOfFastFail(CompletionStage<?>... cfs)

Returns a new Cffu that is successful when all the given stages success, the results(Cffu<Void>) of the given stages are not reflected in the returned Cffu, but may be obtained by inspecting them individually. If any of the given stages complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given stages, with a CompletionException holding this exception as its cause. If no stages are provided, returns a Cffu completed with the value null.

Parameters:

cfs - the stages

Returns:

a new Cffu that is successful when all the given stages success

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• allResultsOfFastFail(CompletionStage[])
• CompletableFutureUtils.allOfFastFail(CompletionStage[])

allResultsOf

@Contract(pure=true)
@SafeVarargs
public final <T> Cffu<List<T>> allResultsOf(CompletionStage<? extends T>... cfs)

Returns a new Cffu with the results in the same order of all the given stages, the new Cffu is completed when all the given stages complete. If any of the given stages complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause. If no stages are provided, returns a Cffu completed with the value empty list.

Parameters:

cfs - the stages

Returns:

a new Cffu that is completed when all the given stages complete

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• allResultsOf(CompletionStage[])

allResultsOfFastFail

@Contract(pure=true)
@SafeVarargs
public final <T> Cffu<List<T>> allResultsOfFastFail(CompletionStage<? extends T>... cfs)

Returns a new Cffu with the results in the same order of all the given stages, the new Cffu success when all the given stages success. If any of the given stages complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given stages, with a CompletionException holding this exception as its cause. If no stages are provided, returns a Cffu completed with the value empty list.

Parameters:

cfs - the stages

Returns:

a new Cffu that is successful when all the given stages success

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• CompletableFutureUtils.allOfFastFail(CompletionStage[])
• allResultsOfFastFail(CompletionStage[])

anyOf

@Contract(pure=true)
@SafeVarargs
public final <T> Cffu<T> anyOf(CompletionStage<? extends T>... cfs)

Returns a new Cffu that is completed when any of the given stages complete, with the same result.
Otherwise, if it completed exceptionally, the returned Cffu also does so, with a CompletionException holding this exception as its cause.
If no stages are provided, returns an incomplete Cffu.

Parameters:

cfs - the stages

Returns:

a new Cffu that is completed with the result or exception from any of the given stages when one completes

Throws:

NullPointerException - if the array or any of its elements are null

See Also:

• anyOf(CompletionStage[])
• CompletableFuture.anyOf(CompletableFuture[])

anyOfSuccess

@SafeVarargs
public final <T> Cffu<T> anyOfSuccess(CompletionStage<? extends T>... cfs)

Returns a new Cffu that is successful when any of the given stages success, with the same result. Otherwise, all the given stages complete exceptionally, the returned Cffu also does so, with a CompletionException holding an exception from any of the given stages as its cause. If no stages are provided, returns a new Cffu that is already completed exceptionally with a CompletionException holding a NoCfsProvidedException as its cause.

Parameters:

cfs - the stages

Returns:

a new Cffu

Throws:

NullPointerException - if the array or any of its elements are null

allTupleOf

@Contract(pure=true)
public <T1,
T2> Cffu<Tuple2<T1,T2>> allTupleOf(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2)

Returns a new Cffu that is completed when the given two CompletableFutures complete. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is completed when the given 2 CompletableFutures complete

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOf(CompletionStage)
• allResultsOf(CompletionStage[])
• allOf(CompletionStage[])

allTupleOfFastFail

@Contract(pure=true)
public <T1,
T2> Cffu<Tuple2<T1,T2>> allTupleOfFastFail(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2)

Returns a new Cffu that is successful when the given two CompletableFutures success. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given CompletableFutures, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is successful when the given two CompletableFutures success

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOfFastFail(CompletionStage)
• allResultsOfFastFail(CompletionStage[])
• allOfFastFail(CompletionStage[])

allTupleOf

@Contract(pure=true)
public <T1,
T2,
T3> Cffu<Tuple3<T1,T2,T3>> allTupleOf(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3)

Returns a new Cffu that is completed when the given three CompletableFutures complete. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is completed when the given 3 CompletableFutures complete

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOf(CompletionStage, CompletionStage)
• allResultsOf(CompletionStage[])
• allOf(CompletionStage[])

allTupleOfFastFail

@Contract(pure=true)
public <T1,
T2,
T3> Cffu<Tuple3<T1,T2,T3>> allTupleOfFastFail(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3)

Returns a new Cffu that is successful when the given three CompletableFutures success. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given CompletableFutures, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is successful when the given three CompletableFutures success

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOfFastFail(CompletionStage, CompletionStage)
• allResultsOfFastFail(CompletionStage[])
• allOfFastFail(CompletionStage[])

allTupleOf

@Contract(pure=true)
public <T1,
T2,
T3,
T4> Cffu<Tuple4<T1,T2,T3,T4>> allTupleOf(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3,
 CompletionStage<? extends T4> cf4)

Returns a new Cffu that is completed when the given 4 CompletableFutures complete. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is completed when the given 4 CompletableFutures complete

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOf(CompletionStage, CompletionStage, CompletionStage)
• allResultsOf(CompletionStage[])
• allOf(CompletionStage[])

allTupleOfFastFail

@Contract(pure=true)
public <T1,
T2,
T3,
T4> Cffu<Tuple4<T1,T2,T3,T4>> allTupleOfFastFail(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3,
 CompletionStage<? extends T4> cf4)

Returns a new Cffu that is successful when the given four CompletableFutures success. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given CompletableFutures, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is successful when the given four CompletableFutures success

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOfFastFail(CompletionStage, CompletionStage, CompletionStage)
• allResultsOfFastFail(CompletionStage[])
• allOfFastFail(CompletionStage[])

allTupleOf

@Contract(pure=true)
public <T1,
T2,
T3,
T4,
T5>
Cffu<Tuple5<T1,T2,T3,T4,T5>> allTupleOf(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3,
 CompletionStage<? extends T4> cf4,
 CompletionStage<? extends T5> cf5)

Returns a new Cffu that is completed when the given 5 CompletableFutures complete. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is completed when the given 5 CompletableFutures complete

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOf(CompletionStage, CompletionStage, CompletionStage, CompletionStage)
• allResultsOf(CompletionStage[])
• allOf(CompletionStage[])

allTupleOfFastFail

@Contract(pure=true)
public <T1,
T2,
T3,
T4,
T5>
Cffu<Tuple5<T1,T2,T3,T4,T5>> allTupleOfFastFail(CompletionStage<? extends T1> cf1,
 CompletionStage<? extends T2> cf2,
 CompletionStage<? extends T3> cf3,
 CompletionStage<? extends T4> cf4,
 CompletionStage<? extends T5> cf5)

Returns a new Cffu that is successful when the given five CompletableFutures success. If any of the given CompletableFutures complete exceptionally, then the returned Cffu also does so *without* waiting other incomplete given CompletableFutures, with a CompletionException holding this exception as its cause.

Returns:

a new Cffu that is successful when the given five CompletableFutures success

Throws:

NullPointerException - if any of the given CompletableFutures are null

See Also:

• Cffu.allTupleOfFastFail(CompletionStage, CompletionStage, CompletionStage, CompletionStage)
• allTupleOfFastFail(CompletionStage, CompletionStage)
• allResultsOfFastFail(CompletionStage[])
• allOfFastFail(CompletionStage[])

delayedExecutor

@Contract(pure=true)
public Executor delayedExecutor(long delay,
 TimeUnit unit)

Returns a new Executor that submits a task to the default executor after the given delay (or no delay if non-positive). Each delay commences upon invocation of the returned executor's execute method.

Parameters:

delay - how long to delay, in units of unit

unit - a TimeUnit determining how to interpret the delay parameter

Returns:

the new delayed executor

delayedExecutor

@Contract(pure=true)
public Executor delayedExecutor(long delay,
 TimeUnit unit,
 Executor executor)

Returns a new Executor that submits a task to the given base executor after the given delay (or no delay if non-positive). Each delay commences upon invocation of the returned executor's execute method.

Parameters:

delay - how long to delay, in units of unit

unit - a TimeUnit determining how to interpret the delay parameter

executor - the base executor

Returns:

the new delayed executor

cffuArrayUnwrap

@Contract(pure=true)
@SafeVarargs
public static <T> CompletableFuture<T>[] cffuArrayUnwrap(Cffu<T>... cfs)

A convenient util method for unwrap input Cffu array elements by Cffu.cffuUnwrap().

Parameters:

cfs - the Cffus

See Also:

• Cffu.cffuUnwrap()

cffuListToArray

@Contract(pure=true)
public static <T> Cffu<T>[] cffuListToArray(List<Cffu<T>> cffuList)

Convert Cffu list to Cffu array.

defaultExecutor

@Contract(pure=true)
public Executor defaultExecutor()

Returns the default Executor used for async methods that do not specify an Executor. Configured by builder(Executor).

Returns:

the default executor

See Also:

• Cffu.defaultExecutor()
• builder(Executor)

forbidObtrudeMethods

@Contract(pure=true)
public boolean forbidObtrudeMethods()

Returns forbidObtrudeMethods or not.

See Also:

• Cffu.obtrudeValue(Object)
• Cffu.obtrudeException(Throwable)
• CffuFactoryBuilder.forbidObtrudeMethods(boolean)