javax.tv.util

Class TVTimerSpec

java.lang.Object

javax.tv.util.TVTimerSpec

public class TVTimerSpec
extends Object

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

Constructors

Constructor and Description
TVTimerSpec() Creates a timer specification.

Method Summary

Methods

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

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

Constructor Detail

TVTimerSpec

public TVTimerSpec()

Creates a timer specification. It initially is absolute, non-repeating, regular specification set to go off at time 0.

Method Detail

setAbsolute

public void setAbsolute(boolean absolute)

Sets this specification to be absolute or delayed.

isAbsolute

public boolean isAbsolute()

Checks if this specification is absolute.

setRepeat

public void setRepeat(boolean repeat)

Sets this specification to be repeating or non-repeating.

isRepeat

public boolean isRepeat()

Checks if this specification is repeating.

setRegular

public void setRegular(boolean regular)

Sets this specification to be regular or non-regular.

isRegular

public boolean isRegular()

Checks if this specification is regular.

setTime

public void setTime(long time)

Sets when this specification should go off. For absolute specifications, this is a time in milliseconds since midnight, January 1, 1970 UTC. For delayed specifications, this is a delay time in milliseconds. If the time parameter passed is negative, this method shall throw an IllegalArgumentException.

Parameters:

time - The time when this specification should go off.

getTime

public long getTime()

Returns the absolute or delay time when this specification will go off.

addTVTimerWentOffListener

public void addTVTimerWentOffListener(TVTimerWentOffListener l)

Registers a listener with this timer specification.

Parameters:

l - The listener to add.

removeTVTimerWentOffListener

public void removeTVTimerWentOffListener(TVTimerWentOffListener l)

Removes a listener to this timer specification. Silently does nothing if the listener was not listening on this specification.

Parameters:

l - The listener to remove.

setAbsoluteTime

public void setAbsoluteTime(long when)

Sets this specification to go off at the given absolute time. This is a convenience function equivalent to setAbsolute(true), setTime(when), setRepeat(false). If the time parameter passed is negative, this method shall throw an IllegalArgumentException.

Parameters:

when - The absolute time for the specification to go off.

setDelayTime

public void setDelayTime(long delay)

Sets this specification to go off after the given delay time. This is a convenience function equivalent to setAbsolute(false), setTime(delay), setRepeat(false).

Parameters:

delay - The relative time for the specification to go off.

notifyListeners

public void notifyListeners(TVTimer source)

Calls all listeners registered on this timer specification. This function is primarily for the benefit of those writing implementations of TVTimers.

Parameters:

source - The TVTimer that decided that this specification should go off.