zmq.util

Class Timers

java.lang.Object

zmq.util.Timers

public final class Timers
extends Object

Manages set of timers. Timers can be added with a given interval, when the interval of time expires after addition, handler method is executed with given arguments. Timer is repetitive and will be executed over time until canceled. This is a DRAFT class, and may change without notice.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Timers.Handler
static class	Timers.Timer

Constructor Summary

Constructors

Constructor and Description
Timers()

Method Summary

Modifier and Type	Method and Description
Timers.Timer	add(long interval, Timers.Handler handler, Object... args) Add timer to the set, timer repeats forever, or until cancel is called.
boolean	cancel(Timers.Timer timer) Cancel a timer.
int	execute() Execute the timers.
boolean	reset(Timers.Timer timer) Reset the timer.
boolean	setInterval(Timers.Timer timer, long interval) Changes the interval of the timer.
int	sleepAndExecute()
long	timeout() Returns the time in millisecond until the next timer.

Methods inherited from class java.lang.Object

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

Constructor Detail

Timers

public Timers()

Method Detail

add

public Timers.Timer add(long interval,
                        Timers.Handler handler,
                        Object... args)

Add timer to the set, timer repeats forever, or until cancel is called.

Parameters:

interval - the interval of repetition in milliseconds.

handler - the callback called at the expiration of the timer.

args - the optional arguments for the handler.

Returns:

an opaque handle for further cancel.

setInterval

public boolean setInterval(Timers.Timer timer,
                           long interval)

Changes the interval of the timer. This method is slow, canceling existing and adding a new timer yield better performance.

Parameters:

timer - the timer to change the interval to.

Returns:

true if set, otherwise false.

reset

public boolean reset(Timers.Timer timer)

Reset the timer. This method is slow, canceling existing and adding a new timer yield better performance.

Parameters:

timer - the timer to reset.

Returns:

true if reset, otherwise false.

cancel

public boolean cancel(Timers.Timer timer)

Cancel a timer.

Parameters:

timer - the timer to cancel.

Returns:

true if cancelled, otherwise false.

timeout

public long timeout()

Returns the time in millisecond until the next timer.

Returns:

the time in millisecond until the next timer.

execute

public int execute()

Execute the timers.

Returns:

the number of timers triggered.

sleepAndExecute

public int sleepAndExecute()