|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.tv.util.TVTimerSpec
public class TVTimerSpec
A class representing a timer specification. A timer specification
declares when a TVTimerWentOffEvent
should be sent.
These events are sent to the listeners registered on the
specification.
A TVTimerSpec
may be absolute or delayed.
Absolute specifications go off at the specified time. Delayed
specifications go off after waiting the specified amount of time.
Delayed specifications may be repeating or non-repeating. Repeating specifications automatically reschedule themselves after going off.
Repeating specifications may be regular or non-regular. Regular specifications attempt to go off at fixed intervals of time, irrespective of system load or how long it takes to notify the listeners. Non-regular specifications wait the specified amount of time after all listeners have been called before going off again.
For example, you could create a repeating specification that goes off every 100 milliseconds. Furthermore, imagine that it takes 5 milliseconds to notify the listeners every time it goes off. If the specification is regular, the listeners will be notified after 100 milliseconds, 200 milliseconds, 300 milliseconds, and so on. If the specification is non-regular, the listeners will be notified after 100 milliseconds, 205 milliseconds, 310 milliseconds, and so on.
Constructor Summary | |
---|---|
TVTimerSpec()
Creates a timer specification. |
Method Summary | |
---|---|
void |
addTVTimerWentOffListener(TVTimerWentOffListener l)
Registers a listener with this timer specification. |
long |
getTime()
Returns the absolute or delay time when this specification will go off. |
boolean |
isAbsolute()
Checks if this specification is absolute. |
boolean |
isRegular()
Checks if this specification is regular. |
boolean |
isRepeat()
Checks if this specification is repeating. |
void |
notifyListeners(TVTimer source)
Calls all listeners registered on this timer specification. |
void |
removeTVTimerWentOffListener(TVTimerWentOffListener l)
Removes a listener to this timer specification. |
void |
setAbsolute(boolean absolute)
Sets this specification to be absolute or delayed. |
void |
setAbsoluteTime(long when)
Sets this specification to go off at the given absolute time. |
void |
setDelayTime(long delay)
Sets this specification to go off after the given delay time. |
void |
setRegular(boolean regular)
Sets this specification to be regular or non-regular. |
void |
setRepeat(boolean repeat)
Sets this specification to be repeating or non-repeating. |
void |
setTime(long time)
Sets when this specification should go off. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public TVTimerSpec()
Method Detail |
---|
public void setAbsolute(boolean absolute)
public boolean isAbsolute()
public void setRepeat(boolean repeat)
public boolean isRepeat()
public void setRegular(boolean regular)
public boolean isRegular()
public void setTime(long time)
time
- The time when this specification should go off.public long getTime()
public void addTVTimerWentOffListener(TVTimerWentOffListener l)
l
- The listener to add.public void removeTVTimerWentOffListener(TVTimerWentOffListener l)
l
- The listener to remove.public void setAbsoluteTime(long when)
setAbsolute(true)
, setTime(when)
,
setRepeat(false)
.
when
- The absolute time for the specification to go off.public void setDelayTime(long delay)
setAbsolute(false)
, setTime(delay)
,
setRepeat(false)
.
delay
- The relative time for the specification to go off.public void notifyListeners(TVTimer source)
source
- The TVTimer that decided that this specification
should go off.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |