Package org.apache.hadoop.util.functional

Class CommonCallableSupplier<T>

java.lang.Object

org.apache.hadoop.util.functional.CommonCallableSupplier<T>

Type Parameters:

T - return type.

All Implemented Interfaces:

java.util.function.Supplier<T>

public final class CommonCallableSupplier<T>
extends java.lang.Object
implements java.util.function.Supplier<T>

A bridge from Callable to Supplier; catching exceptions raised by the callable and wrapping them as appropriate.

Constructor Summary

Constructors

Constructor	Description
CommonCallableSupplier(java.util.concurrent.Callable<T> call)	Create.

Method Summary

Modifier and Type	Method	Description
T	get()
static void	maybeAwaitCompletion(java.util.concurrent.CompletableFuture<java.lang.Void> future)	Block awaiting completion for any non-null future passed in; No-op if a null arg was supplied.
static <T> java.util.concurrent.CompletableFuture<T>	submit(java.util.concurrent.Executor executor, java.util.concurrent.Callable<T> call)	Submit a callable into a completable future.
static <T> void	waitForCompletion(java.util.concurrent.CompletableFuture<T> future)	Wait for a single of future to complete, extracting IOEs afterwards.
static <T> void	waitForCompletion(java.util.List<java.util.concurrent.CompletableFuture<T>> futures)	Wait for a list of futures to complete.
static <T> void	waitForCompletionIgnoringExceptions(java.util.concurrent.CompletableFuture<T> future)	Wait for a single of future to complete, ignoring exceptions raised.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonCallableSupplier

public CommonCallableSupplier(java.util.concurrent.Callable<T> call)

Create.

Parameters:

call - call to invoke.

Method Detail

get

public T get()

Specified by:

get in interface java.util.function.Supplier<T>

submit

public static <T> java.util.concurrent.CompletableFuture<T> submit(java.util.concurrent.Executor executor,
                                                                   java.util.concurrent.Callable<T> call)

Submit a callable into a completable future. RTEs are rethrown. Non RTEs are caught and wrapped; IOExceptions to RuntimeIOException instances.

Type Parameters:

T - type

Parameters:

executor - executor.

call - call to invoke

Returns:

the future to wait for

waitForCompletion

public static <T> void waitForCompletion(java.util.List<java.util.concurrent.CompletableFuture<T>> futures)
                                  throws java.io.IOException

Wait for a list of futures to complete. If the list is empty, return immediately.

Type Parameters:

T - Generics Type T.

Parameters:

futures - list of futures.

Throws:

java.io.IOException - if one of the called futures raised an IOE.

java.lang.RuntimeException - if one of the futures raised one.

waitForCompletion

public static <T> void waitForCompletion(java.util.concurrent.CompletableFuture<T> future)
                                  throws java.io.IOException

Wait for a single of future to complete, extracting IOEs afterwards.

Type Parameters:

T - Generics Type T.

Parameters:

future - future to wait for.

Throws:

java.io.IOException - if one of the called futures raised an IOE.

java.lang.RuntimeException - if one of the futures raised one.

waitForCompletionIgnoringExceptions

public static <T> void waitForCompletionIgnoringExceptions(@Nullable
                                                           java.util.concurrent.CompletableFuture<T> future)

Wait for a single of future to complete, ignoring exceptions raised.

Type Parameters:

T - Generics Type T.

Parameters:

future - future to wait for.

maybeAwaitCompletion

public static void maybeAwaitCompletion(@Nullable
                                        java.util.concurrent.CompletableFuture<java.lang.Void> future)
                                 throws java.io.IOException

Block awaiting completion for any non-null future passed in; No-op if a null arg was supplied.

Parameters:

future - future

Throws:

java.io.IOException - if one of the called futures raised an IOE.

java.lang.RuntimeException - if one of the futures raised one.