Module org.refcodes.controlflow

Package org.refcodes.controlflow

Class ManagedExecutorService

java.lang.Object

org.refcodes.controlflow.ManagedExecutorService

All Implemented Interfaces:

Executor, ExecutorService

public class ManagedExecutorService
extends Object
implements ExecutorService

Usually ExecutorService instances originating from an application server are wrapped with this ManagedExecutorService.

The ManagedExecutorService wraps an ExecutorService and prevents execution of the ExecutorService.shutdown() and ExecutorService.shutdownNow() methods (them methods are not delegated and therewith disabled).

This is helpful when you either expect an ExecutorService passed by an application server or, if none is passed, you retrieve a private ExecutorService yourself:

In the second case, you might want to shutdown your ExecutorService after usage, in the first case you do not want to do so as the application server is to take care on shutdown. You then do not wrap your private ExecutorService; you do wrap any ExecutorService being passed to you (by an application server).

Wrapping the ExecutorService being passed from the application server and not wrapping the one you create yourself will enable you to shutdown the ExecutorService in any case; in case it is your private one, it will be shutdown; in case it is the one from the application server, the shutdown calls are just ignored.

Constructor Summary

Constructors

Constructor	Description
ManagedExecutorService(ExecutorService eExecutorService)	Instantiates a new managed executor service.

Method Summary

Modifier and Type	Method	Description
boolean	awaitTermination(long aTimeout, TimeUnit aUnit)
void	execute(Runnable aArg0)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> aTasks)
<T> List<Future<T>>	invokeAll(Collection<? extends Callable<T>> aTasks, long aTimeout, TimeUnit aUnit)
<T> T	invokeAny(Collection<? extends Callable<T>> aTasks)
<T> T	invokeAny(Collection<? extends Callable<T>> aTasks, long aTimeout, TimeUnit aUnit)
boolean	isShutdown()
boolean	isTerminated()
void	shutdown()
List<Runnable>	shutdownNow()
Future<?>	submit(Runnable aTask)
<T> Future<T>	submit(Runnable aTask, T aResult)
<T> Future<T>	submit(Callable<T> aTask)

Methods inherited from class java.lang.Object

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

Constructor Details

ManagedExecutorService

public ManagedExecutorService(ExecutorService eExecutorService)

Instantiates a new managed executor service.

Parameters:

eExecutorService - the e executor service

Method Details

awaitTermination

public boolean awaitTermination(long aTimeout,
 TimeUnit aUnit)
                         throws InterruptedException

Specified by:

awaitTermination in interface ExecutorService

Throws:

InterruptedException

execute

public void execute(Runnable aArg0)

Specified by:

execute in interface Executor

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> aTasks,
 long aTimeout,
 TimeUnit aUnit)
                              throws InterruptedException

Specified by:

invokeAll in interface ExecutorService

Throws:

InterruptedException

invokeAll

public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> aTasks)
                              throws InterruptedException

Specified by:

invokeAll in interface ExecutorService

Throws:

InterruptedException

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> aTasks,
 long aTimeout,
 TimeUnit aUnit)
                throws InterruptedException,
ExecutionException,
TimeoutException

Specified by:

invokeAny in interface ExecutorService

Throws:

InterruptedException

ExecutionException

TimeoutException

invokeAny

public <T> T invokeAny(Collection<? extends Callable<T>> aTasks)
                throws InterruptedException,
ExecutionException

Specified by:

invokeAny in interface ExecutorService

Throws:

InterruptedException

ExecutionException

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface ExecutorService

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface ExecutorService

shutdown

public void shutdown()

Specified by:

shutdown in interface ExecutorService

shutdownNow

public List<Runnable> shutdownNow()

Specified by:

shutdownNow in interface ExecutorService

submit

public <T> Future<T> submit(Callable<T> aTask)

Specified by:

submit in interface ExecutorService

submit

public <T> Future<T> submit(Runnable aTask,
 T aResult)

Specified by:

submit in interface ExecutorService

submit

public Future<?> submit(Runnable aTask)

Specified by:

submit in interface ExecutorService