com.amadeus.session

Class ExecutorFacade

java.lang.Object

com.amadeus.session.ExecutorFacade

All Implemented Interfaces:

Thread.UncaughtExceptionHandler, ThreadFactory

public class ExecutorFacade
extends Object
implements Thread.UncaughtExceptionHandler, ThreadFactory

Support class that provides methods for launching and scheduling of tasks. The implementation will use either managed thread factory when supported by JEE container, or Executors.defaultThreadFactory() if the managed one was not available.

The implementation also provides metrics about number of thread in pool and number of active threads.

Constructor Summary

Constructors

Constructor and Description
ExecutorFacade(SessionConfiguration conf) Default constructor

Method Summary

Modifier and Type	Method and Description
Thread	newThread(Runnable r) This method creates new thread from pool and add namespace to the thread name.
ScheduledFuture<?>	scheduleAtFixedRate(Runnable task, long initialDelay, long period, TimeUnit unit) Creates and executes a periodic action that becomes enabled first after the given initial delay, and subsequently with the given period; that is executions will commence after initialDelay then initialDelay+period, then initialDelay + 2 * period, and so on.
void	shutdown() Called to shutdown the executor and finish all submitted tasks.
Future<?>	submit(Runnable task) Submits a Runnable task for execution and returns a Future representing that task.
void	uncaughtException(Thread t, Throwable e) The method will log uncaught exceptions that occurred during thread execution.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorFacade

public ExecutorFacade(SessionConfiguration conf)

Default constructor

Parameters:

conf - namespace for metrics

Method Detail

newThread

public Thread newThread(Runnable r)

This method creates new thread from pool and add namespace to the thread name.

Specified by:

newThread in interface ThreadFactory

submit

public Future<?> submit(Runnable task)

Submits a Runnable task for execution and returns a Future representing that task. The Future's get method will return null upon successful completion.

Parameters:

task - the task to submit

Returns:

a Future representing pending completion of the task

Throws:

RejectedExecutionException - if the task cannot be scheduled for execution

NullPointerException - if the task is null

scheduleAtFixedRate

public ScheduledFuture<?> scheduleAtFixedRate(Runnable task,
                                              long initialDelay,
                                              long period,
                                              TimeUnit unit)

Creates and executes a periodic action that becomes enabled first after the given initial delay, and subsequently with the given period; that is executions will commence after initialDelay then initialDelay+period, then initialDelay + 2 * period, and so on. If any execution of the task encounters an exception, subsequent executions are suppressed. Otherwise, the task will only terminate via cancellation or termination of the executor. If any execution of this task takes longer than its period, then subsequent executions may start late, but will not concurrently execute.

Parameters:

task - the task to execute

initialDelay - the time to delay first execution

period - the period between successive executions

unit - the time unit of the initialDelay and period parameters

Returns:

a ScheduledFuture representing pending completion of the task, and whose get() method will throw an exception upon cancellation

Throws:

RejectedExecutionException - if the task cannot be scheduled for execution

NullPointerException - if command is null

IllegalArgumentException - if period less than or equal to zero

uncaughtException

public void uncaughtException(Thread t,
                              Throwable e)

The method will log uncaught exceptions that occurred during thread execution.

Specified by:

uncaughtException in interface Thread.UncaughtExceptionHandler

shutdown

public void shutdown()

Called to shutdown the executor and finish all submitted tasks.