org.springframework.scheduling.commonj

Class TimerManagerTaskScheduler

java.lang.Object

org.springframework.jndi.JndiAccessor

org.springframework.jndi.JndiLocatorSupport

org.springframework.scheduling.commonj.TimerManagerAccessor

org.springframework.scheduling.commonj.TimerManagerTaskScheduler

All Implemented Interfaces:

DisposableBean, InitializingBean, Lifecycle, TaskScheduler

public class TimerManagerTaskScheduler
extends TimerManagerAccessor
implements TaskScheduler

Implementation of Spring's TaskScheduler interface, wrapping a CommonJ commonj.timers.TimerManager.

Since:

3.0

Author:

Juergen Hoeller, Mark Fisher

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	TimerManagerTaskScheduler.ReschedulingTimerListener ScheduledFuture adapter for trigger-based rescheduling.
private static class	TimerManagerTaskScheduler.TimerScheduledFuture ScheduledFuture adapter that wraps a CommonJ Timer.

Field Summary

Fields

Modifier and Type	Field and Description
private ErrorHandler	errorHandler

Fields inherited from class org.springframework.jndi.JndiLocatorSupport

CONTAINER_PREFIX

Fields inherited from class org.springframework.jndi.JndiAccessor

logger

Constructor Summary

Constructors

Constructor and Description
TimerManagerTaskScheduler()

Method Summary

Modifier and Type	Method and Description
private java.lang.Runnable	errorHandlingTask(java.lang.Runnable delegate, boolean isRepeatingTask)
java.util.concurrent.ScheduledFuture<?>	schedule(java.lang.Runnable task, java.util.Date startTime) Schedule the given Runnable, invoking it at the specified execution time.
java.util.concurrent.ScheduledFuture<?>	schedule(java.lang.Runnable task, Trigger trigger) Schedule the given Runnable, invoking it whenever the trigger indicates a next execution time.
java.util.concurrent.ScheduledFuture<?>	scheduleAtFixedRate(java.lang.Runnable task, java.util.Date startTime, long period) Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given period.
java.util.concurrent.ScheduledFuture<?>	scheduleAtFixedRate(java.lang.Runnable task, long period) Schedule the given Runnable, starting as soon as possible and invoking it with the given period.
java.util.concurrent.ScheduledFuture<?>	scheduleWithFixedDelay(java.lang.Runnable task, java.util.Date startTime, long delay) Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given delay between the completion of one execution and the start of the next.
java.util.concurrent.ScheduledFuture<?>	scheduleWithFixedDelay(java.lang.Runnable task, long delay) Schedule the given Runnable, starting as soon as possible and invoking it with the given delay between the completion of one execution and the start of the next.
void	setErrorHandler(ErrorHandler errorHandler) Provide an ErrorHandler strategy.

Methods inherited from class org.springframework.scheduling.commonj.TimerManagerAccessor

afterPropertiesSet, destroy, getTimerManager, isRunning, setShared, setTimerManager, setTimerManagerName, start, stop

Methods inherited from class org.springframework.jndi.JndiLocatorSupport

convertJndiName, isResourceRef, lookup, lookup, setResourceRef

Methods inherited from class org.springframework.jndi.JndiAccessor

getJndiEnvironment, getJndiTemplate, setJndiEnvironment, setJndiTemplate

Methods inherited from class java.lang.Object

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

Field Detail

errorHandler

private volatile ErrorHandler errorHandler

Constructor Detail

TimerManagerTaskScheduler

public TimerManagerTaskScheduler()

Method Detail

setErrorHandler

public void setErrorHandler(ErrorHandler errorHandler)

Provide an ErrorHandler strategy.

schedule

public java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable task,
                                                        Trigger trigger)

Description copied from interface: TaskScheduler

Schedule the given Runnable, invoking it whenever the trigger indicates a next execution time.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

schedule in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

trigger - an implementation of the Trigger interface, e.g. a CronTrigger object wrapping a cron expression

Returns:

a ScheduledFuture representing pending completion of the task, or null if the given Trigger object never fires (i.e. returns null from Trigger.nextExecutionTime(org.springframework.scheduling.TriggerContext))

See Also:

CronTrigger

schedule

public java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable task,
                                                        java.util.Date startTime)

Description copied from interface: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

schedule in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

startTime - the desired execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

Returns:

a ScheduledFuture representing pending completion of the task

scheduleAtFixedRate

public java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task,
                                                                   java.util.Date startTime,
                                                                   long period)

Description copied from interface: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given period.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

scheduleAtFixedRate in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

startTime - the desired first execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

period - the interval between successive executions of the task (in milliseconds)

Returns:

a ScheduledFuture representing pending completion of the task

scheduleAtFixedRate

public java.util.concurrent.ScheduledFuture<?> scheduleAtFixedRate(java.lang.Runnable task,
                                                                   long period)

Description copied from interface: TaskScheduler

Schedule the given Runnable, starting as soon as possible and invoking it with the given period.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

scheduleAtFixedRate in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

period - the interval between successive executions of the task (in milliseconds)

Returns:

a ScheduledFuture representing pending completion of the task

scheduleWithFixedDelay

public java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task,
                                                                      java.util.Date startTime,
                                                                      long delay)

Description copied from interface: TaskScheduler

Schedule the given Runnable, invoking it at the specified execution time and subsequently with the given delay between the completion of one execution and the start of the next.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

scheduleWithFixedDelay in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

startTime - the desired first execution time for the task (if this is in the past, the task will be executed immediately, i.e. as soon as possible)

delay - the delay between the completion of one execution and the start of the next (in milliseconds)

Returns:

a ScheduledFuture representing pending completion of the task

scheduleWithFixedDelay

public java.util.concurrent.ScheduledFuture<?> scheduleWithFixedDelay(java.lang.Runnable task,
                                                                      long delay)

Description copied from interface: TaskScheduler

Schedule the given Runnable, starting as soon as possible and invoking it with the given delay between the completion of one execution and the start of the next.

Execution will end once the scheduler shuts down or the returned ScheduledFuture gets cancelled.

Specified by:

scheduleWithFixedDelay in interface TaskScheduler

Parameters:

task - the Runnable to execute whenever the trigger fires

delay - the interval between successive executions of the task (in milliseconds)

Returns:

a ScheduledFuture representing pending completion of the task

errorHandlingTask

private java.lang.Runnable errorHandlingTask(java.lang.Runnable delegate,
                                             boolean isRepeatingTask)