org.frameworkset.schedule

Interface TaskScheduler

All Known Implementing Classes:

ThreadPoolTaskScheduler

public interface TaskScheduler

Method Summary

Modifier and Type	Method and Description
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.

Method Detail

schedule

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.

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

Parameters:

task - the Runnable to execute whenever the trigger fires

trigger - an implementation of the Trigger interface, e.g. a org.frameworkset.scheduling.support.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.frameworkset.schedule.TriggerContext))

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)

See Also:

org.frameworkset.scheduling.support.CronTrigger

schedule

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

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.

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

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)

scheduleAtFixedRate

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.

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

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

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)

scheduleAtFixedRate

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.

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

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

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)

scheduleWithFixedDelay

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.

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

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

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)

scheduleWithFixedDelay

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.

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

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

Throws:

org.frameworkset.core.task.TaskRejectedException - if the given task was not accepted for internal reasons (e.g. a pool overload handling policy or a pool shutdown in progress)