| java.lang.Object
 com.sun.util.PTimer
All known Subclasses: com.sun.util.DefaultPTimer,
| PTimer | | abstract public class PTimer (Code) | | A class representing a timer.
A timer is responsible for managing a set of timer events specified
by timer specifications. When the timer event should be sent,
the timer calls the timer specification's notifyListeners method.
Compatibility
The PTimer class is available on PersonalJava implementations,
but is not available on J2SE platforms. It is optional on Personal
Profile implementations, but has been deprecated. The java.util.timer
class should be used instead, except in cases where PersonalJava
compatibility is necessary.
since:
PersonalJava1.0 |
| Method Summary | |
| abstract public void | deschedule(PTimerSpec t)
Stop events from being delivered. | | abstract public long | getGranularity()
Report the granularity of this timer, i.e. | | abstract public long | getMinRepeatInterval()
Report the minimum interval that this timer can repeat tasks.
For example, it's perfectly reasonable for a Timer to specify that
the minimum interval for a repeatedly performed task is 1000 msec in
between every run. | | public static PTimer | getTimer()
Returns the default timer for the system. | | abstract public void | schedule(PTimerSpec t)
| | abstract public PTimerSpec | scheduleTimerSpec(PTimerSpec t)
Begins monitoring a PTimerSpec. |
| deschedule | | abstract public void deschedule(PTimerSpec t)(Code) | | Stop events from being delivered.
Removes a timer specification from the set of monitored specifications.
The descheduling happens as soon as practical, but may not happen immediately.
If the timer specification has been scheduled multiple times with this
timer, all the schedulings are cancelled.
|
| getGranularity | | abstract public long getGranularity()(Code) | | Report the granularity of this timer, i.e. the length of time between
"tick"s of this timer.
The timer's best knowledge of the granularity inmili-seconds. Return -1 if this timer doesn't know its granularity. |
| getMinRepeatInterval | | abstract public long getMinRepeatInterval()(Code) | | Report the minimum interval that this timer can repeat tasks.
For example, it's perfectly reasonable for a Timer to specify that
the minimum interval for a repeatedly performed task is 1000 msec in
between every run. This is to avoid possible system overloading.
The timer's best knowledge of minimum repeat intervalin mili-seconds. Return -1 if this timer doesn't know its repeatinginterval limitation. |
| getTimer | | public static PTimer getTimer()(Code) | | Returns the default timer for the system.
There may be one PTimer instance per virtual machine,
one per applet, one per call to getTimer, or some other platform dependent
implementation.
A non-null PTimer object. |
| scheduleTimerSpec | | abstract public PTimerSpec scheduleTimerSpec(PTimerSpec t) throws PTimerScheduleFailedException(Code) | | Begins monitoring a PTimerSpec. When the timer
specification should go off, the timer will call
PTimerSpec.notifyListeners.
Returns the real PTimerSpec that got scheduled. If you schedule a
spec that implies a smaller granularity than this timer can provide,
or a repeat timer spec that has a smaller repeating interval than
this timer can provide, the timer should round to the closest value
and return that value as a
PTimerSpec object. An interested application
can use accessor methods
PTimer.getMinRepeatInterval and
PTimer.getGranularity to
obtain the Timer's best knowledge of the Timer's limitation on
granularity and repeat interval. If you schedule an
absolute specification that should have gone off already, it will
go off immediately. If the scheduled specification can not be met
at all, the exception
PTimerScheduleFailedException should be
thrown.
You may schedule a timer specification with multiple timers.
You may schedule a timer specification with the same timer
multiple times (in which case it will go off multiple times). If
you modify a timer specification after it has been scheduled
with any timer, the results are unspecified.
Parameters:
t - The timer specification to begin monitoring. The real PTimerSpec that was scheduled.
exception:
PTimerScheduleFailedException - is thrown when the scheduledspec can not be met at all. |
|
|