org.apache.jackrabbit.util

Class Timer

java.lang.Object

org.apache.jackrabbit.util.Timer

public class Timer
extends Object

Timer wraps the standard Java Timer class and implements a guaranteed shutdown of the background thread running in the Timer instance after a certain IDLE_TIME.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Timer.Task Extends the TimerTask with callback hooks to this Timer implementation.

Constructor Summary

Constructors

Constructor and Description
Timer(boolean isDeamon) Creates a new Timer instance.

Method Summary

Modifier and Type	Method and Description
void	cancel() Terminates this timer, discarding any currently scheduled tasks.
void	schedule(Timer.Task task, long delay, long period) Schedules the specified task for repeated fixed-delay execution, beginning after the specified delay.

Methods inherited from class java.lang.Object

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

Constructor Detail

Timer

public Timer(boolean isDeamon)

Creates a new Timer instance.

Parameters:

isDeamon - if true the background thread wil run as deamon.

Method Detail

schedule

public void schedule(Timer.Task task,
                     long delay,
                     long period)

Schedules the specified task for repeated fixed-delay execution, beginning after the specified delay. Subsequent executions take place at approximately regular intervals separated by the specified period.

Parameters:

task - task to be scheduled.

delay - delay in milliseconds before task is to be executed.

period - time in milliseconds between successive task executions.

Throws:

IllegalArgumentException - if delay is negative, or delay + System.currentTimeMillis() is negative.

IllegalStateException - if task was already scheduled or cancelled, timer was cancelled, or timer thread terminated.

See Also:

Timer.schedule(java.util.TimerTask, long, long)

cancel

public void cancel()

Terminates this timer, discarding any currently scheduled tasks. Does not interfere with a currently executing task (if it exists). Once a timer has been terminated, its execution thread terminates gracefully, and no more tasks may be scheduled on it.

Note that calling this method from within the run method of a timer task that was invoked by this timer absolutely guarantees that the ongoing task execution is the last task execution that will ever be performed by this timer.

This method may be called repeatedly; the second and subsequent calls have no effect.