Package pl.morgwai.base.utils.concurrent

Class ScheduledTaskTrackingThreadPoolExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

java.util.concurrent.ThreadPoolExecutor

java.util.concurrent.ScheduledThreadPoolExecutor

pl.morgwai.base.utils.concurrent.ScheduledTaskTrackingThreadPoolExecutor

All Implemented Interfaces:

Executor, ExecutorService, ScheduledExecutorService, TaskTrackingExecutor, TaskTrackingExecutor.TaskTrackingExecutorDecorator.HookableExecutor

public class ScheduledTaskTrackingThreadPoolExecutor
extends ScheduledThreadPoolExecutor
implements TaskTrackingExecutor, TaskTrackingExecutor.TaskTrackingExecutorDecorator.HookableExecutor

A ScheduledThreadPoolExecutor that is also a TaskTrackingExecutor. Decorates scheduled items with ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution, so that the original tasks can be obtained from the result of tryForceTerminate().

NOTE: due to the design of task decorating in ScheduledThreadPoolExecutor this class is extremely slow in case of a large number of very tiny tasks. See the comment with an explanation in the source.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution<V>	Decorates a RunnableScheduledFuture to allow to obtain the original scheduled task.

Nested classes/interfaces inherited from class java.util.concurrent.ThreadPoolExecutor

ThreadPoolExecutor.AbortPolicy, ThreadPoolExecutor.CallerRunsPolicy, ThreadPoolExecutor.DiscardOldestPolicy, ThreadPoolExecutor.DiscardPolicy

Nested classes/interfaces inherited from interface pl.morgwai.base.utils.concurrent.TaskTrackingExecutor

TaskTrackingExecutor.ForcedTerminationAftermath, TaskTrackingExecutor.TaskTrackingExecutorDecorator

Constructor Summary

Constructors

Constructor	Description
ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize)
ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize, RejectedExecutionHandler handler)
ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize, ThreadFactory threadFactory)
ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize, ThreadFactory threadFactory, RejectedExecutionHandler handler)

Method Summary

Modifier and Type	Method	Description
void	addAfterExecuteHook(BiConsumer<Runnable,Throwable> hook)	Adds hook to be executed in afterExecute(Runnable, Throwable).
void	addBeforeExecuteHook(BiConsumer<Thread,Runnable> hook)	Adds hook to be executed in beforeExecute(Thread, Runnable).
protected void	afterExecute(Runnable task, Throwable error)	Executes all addAfterExecuteHook(BiConsumer) added hooks} in the order they were added.
protected void	beforeExecute(Thread worker, Runnable task)	Executes all added hooks in the reverse order they were added.
protected <V> ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution<V>	decorateTask(Runnable task, RunnableScheduledFuture<V> scheduledExecution)	Decorates task using ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution.
protected <V> ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution<V>	decorateTask(Callable<V> task, RunnableScheduledFuture<V> scheduledExecution)	Decorates task using ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution.
TaskTrackingExecutor.ForcedTerminationAftermath	tryForceTerminate()	Calls ExecutorService.shutdownNow() and returns an object containing a List of tasks, that were still running right before the call.

Methods inherited from class java.util.concurrent.ScheduledThreadPoolExecutor

execute, getContinueExistingPeriodicTasksAfterShutdownPolicy, getExecuteExistingDelayedTasksAfterShutdownPolicy, getQueue, getRemoveOnCancelPolicy, schedule, schedule, scheduleAtFixedRate, scheduleWithFixedDelay, setContinueExistingPeriodicTasksAfterShutdownPolicy, setExecuteExistingDelayedTasksAfterShutdownPolicy, setRemoveOnCancelPolicy, shutdown, shutdownNow, submit, submit, submit

Methods inherited from class java.util.concurrent.ThreadPoolExecutor

allowCoreThreadTimeOut, allowsCoreThreadTimeOut, awaitTermination, finalize, getActiveCount, getCompletedTaskCount, getCorePoolSize, getKeepAliveTime, getLargestPoolSize, getMaximumPoolSize, getPoolSize, getRejectedExecutionHandler, getTaskCount, getThreadFactory, isShutdown, isTerminated, isTerminating, prestartAllCoreThreads, prestartCoreThread, purge, remove, setCorePoolSize, setKeepAliveTime, setMaximumPoolSize, setRejectedExecutionHandler, setThreadFactory, terminated, toString

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, newTaskFor, newTaskFor

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.Executor

execute

Methods inherited from interface java.util.concurrent.ExecutorService

awaitTermination, invokeAll, invokeAll, invokeAny, invokeAny, isShutdown, isTerminated, shutdown, shutdownNow, submit, submit, submit

Methods inherited from interface pl.morgwai.base.utils.concurrent.TaskTrackingExecutor

awaitTermination, toAwaitableOfEnforcedTermination, toAwaitableOfTermination

Constructor Detail

ScheduledTaskTrackingThreadPoolExecutor

public ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize)

ScheduledTaskTrackingThreadPoolExecutor

public ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize,
                                               ThreadFactory threadFactory)

ScheduledTaskTrackingThreadPoolExecutor

public ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize,
                                               RejectedExecutionHandler handler)

ScheduledTaskTrackingThreadPoolExecutor

public ScheduledTaskTrackingThreadPoolExecutor(int corePoolSize,
                                               ThreadFactory threadFactory,
                                               RejectedExecutionHandler handler)

Method Detail

tryForceTerminate

public TaskTrackingExecutor.ForcedTerminationAftermath tryForceTerminate()

Description copied from interface: TaskTrackingExecutor

Calls ExecutorService.shutdownNow() and returns an object containing a List of tasks, that were still running right before the call. The returned object also contains the List of tasks returned by ExecutorService.shutdownNow() itself.

Specified by:

tryForceTerminate in interface TaskTrackingExecutor

addBeforeExecuteHook

public void addBeforeExecuteHook(BiConsumer<Thread,Runnable> hook)

Adds hook to be executed in beforeExecute(Thread, Runnable).

Specified by:

addBeforeExecuteHook in interface TaskTrackingExecutor.TaskTrackingExecutorDecorator.HookableExecutor

beforeExecute

protected final void beforeExecute(Thread worker,
                                   Runnable task)

Executes all added hooks in the reverse order they were added.

Overrides:

beforeExecute in class ThreadPoolExecutor

addAfterExecuteHook

public void addAfterExecuteHook(BiConsumer<Runnable,Throwable> hook)

Adds hook to be executed in afterExecute(Runnable, Throwable).

Specified by:

addAfterExecuteHook in interface TaskTrackingExecutor.TaskTrackingExecutorDecorator.HookableExecutor

afterExecute

protected final void afterExecute(Runnable task,
                                  Throwable error)

Executes all addAfterExecuteHook(BiConsumer) added hooks} in the order they were added.

Overrides:

afterExecute in class ThreadPoolExecutor

decorateTask

protected <V> ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution<V> decorateTask(Runnable task,
                                                                                         RunnableScheduledFuture<V> scheduledExecution)

Decorates task using ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution.

Overrides:

decorateTask in class ScheduledThreadPoolExecutor

decorateTask

protected <V> ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution<V> decorateTask(Callable<V> task,
                                                                                         RunnableScheduledFuture<V> scheduledExecution)

Decorates task using ScheduledTaskTrackingThreadPoolExecutor.ScheduledExecution.

Overrides:

decorateTask in class ScheduledThreadPoolExecutor