core.tut.pori.context

Class ExecutorHandler

java.lang.Object

core.tut.pori.context.ExecutorHandler

public class ExecutorHandler
extends java.lang.Object

Handles system executors. This class can be used to retrieve instances of the system executor service and the quartz scheduler. This class requires PropertyHandler to be initialized. One should not initialize this handler directly, as an instantiated version is available from ServiceInitializer.

Constructor Summary

Constructors

Constructor and Description
ExecutorHandler()

Method Summary

Modifier and Type	Method and Description
void	close()
java.util.concurrent.ExecutorService	getExecutor() Note: if you are planning to run repetitive and non-time specific background tasks, you should implement Job and use getScheduler().
org.quartz.Scheduler	getScheduler() Note: you should not run long-running background tasks, which may reserve the scheduler for a long time.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorHandler

public ExecutorHandler()
                throws java.lang.IllegalArgumentException

Throws:

java.lang.IllegalArgumentException

Method Detail

close

public void close()

getScheduler

public org.quartz.Scheduler getScheduler()

Note: you should not run long-running background tasks, which may reserve the scheduler for a long time. If you need to do multiple functions, split the task to separate Jobs, and use triggers to launch new jobs. Especially, do NOT use sleep(), if you need to wait, schedule your job to re-run again at a later date. Do NOT close or cleanup the instances returned by this method, the initialization and destruction is handled automatically.

Returns:

quartz scheduler for background jobs

getExecutor

public java.util.concurrent.ExecutorService getExecutor()

Note: if you are planning to run repetitive and non-time specific background tasks, you should implement Job and use getScheduler(). The scheduler is meant for short duration tasks. Do not abuse it. Do NOT close or cleanup the instances returned by this method, the initialization and destruction is handled automatically.

Returns:

the executor service