no.digipost.concurrent.executor

Class DefaultExecutors

java.lang.Object

no.digipost.concurrent.executor.DefaultExecutors

public final class DefaultExecutors
extends Object

Method Summary

Modifier and Type	Method and Description
static void	ensureShutdown(ExecutorService executor, Duration timeoutBeforeForcefulShutdown) Perform an orderly shutdown, trying to wait for any currently running tasks to finish, or else forcefully shutdown the executor if the tasks are not able to finish their work within the given timeout duration.
static void	ensureShutdown(String executorName, ExecutorService executor, Duration timeoutBeforeForcefulShutdown) Perform an orderly shutdown, trying to wait for any currently running tasks to finish, or else forcefully shutdown the executor if the tasks are not able to finish their work within the given timeout duration.
static ExecutorService	externallyManaged(ExecutorService executor) Wraps another ExecutorService as an "externally managed executor service", which will discard any invocations of the methods used to manage the lifecycle of the ExecutorService itself.
static ExecutorService	fixedThreadPool(int threadAmount, String name)
static boolean	isExternallyManaged(ExecutorService executor) Determine if the given ExecutorService is marked as externally managed.
static ExecutorService	singleThreaded(String name)
static ThreadFactory	threadNamingFactory(LongFunction<String> threadName)
static ThreadFactory	threadNamingFactory(LongFunction<String> threadName, ThreadFactory backingFactory)

Methods inherited from class java.lang.Object

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

Method Detail

fixedThreadPool

public static ExecutorService fixedThreadPool(int threadAmount,
                                              String name)

singleThreaded

public static ExecutorService singleThreaded(String name)

threadNamingFactory

public static ThreadFactory threadNamingFactory(LongFunction<String> threadName)

threadNamingFactory

public static ThreadFactory threadNamingFactory(LongFunction<String> threadName,
                                                ThreadFactory backingFactory)

externallyManaged

public static ExecutorService externallyManaged(ExecutorService executor)

Wraps another ExecutorService as an "externally managed executor service", which will discard any invocations of the methods used to manage the lifecycle of the ExecutorService itself. This includes the methods:

• ExecutorService.shutdown()
• ExecutorService.shutdownNow() (returns empty list)
• ExecutorService.awaitTermination(long, TimeUnit) (immediately returns with the result of ExecutorService.isTerminated())

An externally managed executor will not be attempted shut down by ensureShutdown(ExecutorService, Duration).

isExternallyManaged

public static boolean isExternallyManaged(ExecutorService executor)

Determine if the given ExecutorService is marked as externally managed.

ensureShutdown

public static void ensureShutdown(ExecutorService executor,
                                  Duration timeoutBeforeForcefulShutdown)

Perform an orderly shutdown, trying to wait for any currently running tasks to finish, or else forcefully shutdown the executor if the tasks are not able to finish their work within the given timeout duration. The ensureShutdown(String, ExecutorService, Duration) method is preferred over this.

Parameters:

executor - the ExecutorService to shut down.

timeoutBeforeForcefulShutdown - the maximum amount of time to wait for tasks to finish before forcefully shutting down the executor.

ensureShutdown

public static void ensureShutdown(String executorName,
                                  ExecutorService executor,
                                  Duration timeoutBeforeForcefulShutdown)

Perform an orderly shutdown, trying to wait for any currently running tasks to finish, or else forcefully shutdown the executor if the tasks are not able to finish their work within the given timeout duration.

Parameters:

executorName - a descriptive name of the executor to shut down, used for logging.

executor - the ExecutorService to shut down.

timeoutBeforeForcefulShutdown - the maximum amount of time to wait for tasks to finish before forcefully shutting down the executor.