Class Timer

  extended by 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
static class Timer.Task
          Extends the TimerTask with callback hooks to this Timer implementation.
Constructor Summary
Timer(boolean isDeamon)
          Creates a new Timer instance.
Method Summary
 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


public Timer(boolean isDeamon)
Creates a new Timer instance.

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


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.

task - task to be scheduled.
delay - delay in milliseconds before task is to be executed.
period - time in milliseconds between successive task executions.
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)


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.

Copyright © 2004-2009 The Apache Software Foundation. All Rights Reserved.