org.quartz.plugins

Class SchedulerPluginWithUserTransactionSupport

java.lang.Object

org.quartz.plugins.SchedulerPluginWithUserTransactionSupport

All Implemented Interfaces:

SchedulerPlugin

Direct Known Subclasses:

JobInitializationPlugin

public abstract class SchedulerPluginWithUserTransactionSupport
extends java.lang.Object
implements SchedulerPlugin

Base class for plugins that wish to support having their start and shutdown methods run within a UserTransaction. This is often necessary if using the JobStoreCMT and the plugin interacts with jobs/triggers.

The subclass should implement start(UserTransaction) and shutdown(UserTransaction). The UserTransaction will be non-null if property wrapInUserTransaction is set to true.

For convenience, this base class also provides an initialize() implementation which saves the scheduler and plugin name, as well as getLog() for logging.

Constructor Summary

Constructors

Constructor and Description
SchedulerPluginWithUserTransactionSupport()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	getWrapInUserTransaction() Wrap the start() and shutdown() methods in a UserTransaction.
void	initialize(java.lang.String name, Scheduler scheduler) Called during creation of the Scheduler in order to give the SchedulerPlugin a chance to initialize.
void	setWrapInUserTransaction(boolean wrapInUserTransaction) Wrap the start() and shutdown() methods in a UserTransaction.
void	shutdown() Based on the value of wrapInUserTransaction, wraps the call to shutdown(UserTransaction) in a UserTransaction.
void	start() Based on the value of wrapInUserTransaction, wraps the call to start(UserTransaction) in a UserTransaction.

Methods inherited from class java.lang.Object

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

Constructor Detail

SchedulerPluginWithUserTransactionSupport

public SchedulerPluginWithUserTransactionSupport()

Method Detail

initialize

public void initialize(java.lang.String name,
              Scheduler scheduler)
                throws SchedulerException

Description copied from interface: SchedulerPlugin

Called during creation of the Scheduler in order to give the SchedulerPlugin a chance to initialize.

At this point, the Scheduler's JobStore is not yet initialized.

If you need direct access your plugin, for example during Job execution, you can have this method explicitly put a reference to this plugin in the Scheduler's SchedulerContext.

Specified by:

initialize in interface SchedulerPlugin

Parameters:

name - The name by which the plugin is identified.

scheduler - The scheduler to which the plugin is registered.

Throws:

SchedulerConfigException - if there is an error initializing.

SchedulerException

getWrapInUserTransaction

public boolean getWrapInUserTransaction()

Wrap the start() and shutdown() methods in a UserTransaction. This is necessary for some plugins if using the JobStoreCMT.

setWrapInUserTransaction

public void setWrapInUserTransaction(boolean wrapInUserTransaction)

Wrap the start() and shutdown() methods in a UserTransaction. This is necessary for some plugins if using the JobStoreCMT.

start

public void start()

Based on the value of wrapInUserTransaction, wraps the call to start(UserTransaction) in a UserTransaction.

Specified by:

start in interface SchedulerPlugin

shutdown

public void shutdown()

Based on the value of wrapInUserTransaction, wraps the call to shutdown(UserTransaction) in a UserTransaction.

Specified by:

shutdown in interface SchedulerPlugin