/**
* Allows for easy creation of asynchronous computations that will be executed in the future. <br>
* The purpose is to allow the user to invoke a side-effecting function that may succeed/fail but
* has now return type. <br>
* E.g. deleting something from a database may not have an interesting return type. One is only
* interested of the outcome, {@link Success}/{@link Failure}. <br>
* The method relays the execution to {@link Future#apply(ThrowableFunction0)}. <br>
* Best used in conjunction with statically importing this method.
*
* <blockquote>
*
* <pre>
* import static javascalautils.concurrent.FutureCompanion.Future;
*
* Future<Unit> t = Future(() -> {
* database.delete(someId);
* });
* </pre>
*
* </blockquote>
*
* @param function The function to render either the value <i>T</i> or raise an exception.
* @return The future that will hold either {@link Unit} or an exception.
* @since 1.9
* @see Future#apply(ThrowableFunction0)
*/
public static Future<Unit> Future(VoidFunction0 function) {
return Future(
() -> {
function.apply();
return Unit.Instance;
});
}
/**
* Allows for easy creation of asynchronous computations that will be executed in the future. <br>
* The purpose is to allow the user to invoke a side-effecting function that may succeed/fail but
* has now return type. <br>
* E.g. deleting something from a database may not have an interesting return type. One is only
* interested of the outcome, {@link Success}/{@link Failure}. <br>
* The method relays the execution to {@link Future#apply(ThrowableFunction0)}. <br>
* Best used in conjunction with statically importing this method.
*
* <blockquote>
*
* <pre>
* import static javascalautils.concurrent.FutureCompanion.Future;
*
* Future<Unit> t = Future(() -> {
* database.delete(someId);
* }, someExecutor);
* </pre>
*
* </blockquote>
*
* @param function The function to render either the value <i>T</i> or raise an exception.
* @param executor The executor to use to compute/execute the Future holding the provided function
* @return The future that will hold either {@link Unit} or an exception.
* @since 1.9
* @see Future#apply(ThrowableFunction0)
*/
public static Future<Unit> Future(VoidFunction0 function, Executor executor) {
return Future(
() -> {
function.apply();
return Unit.Instance;
},
executor);
}
