xapi.time.impl

Class AbstractTimeService

java.lang.Object

xapi.time.impl.ImmutableMoment

xapi.time.impl.AbstractTimeService

All Implemented Interfaces:

Serializable, Comparable<Moment>, Moment, TimeService

Direct Known Subclasses:

TimeServiceDefault, TimeServiceGwt

public abstract class AbstractTimeService
extends ImmutableMoment
implements TimeService

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected double	now

Fields inherited from interface xapi.time.service.TimeService

milli_to_nano, second_to_nano

Constructor Summary

Constructors

Constructor and Description
AbstractTimeService()

Method Summary

Modifier and Type	Method and Description
double	birth() the epoch in millis when this TimeService was instantiated
Moment	clone(Moment moment) creates an immutable copy of a moment
double	millis()
Moment	now()
Moment	nowPlusOne() Returns a new moment guaranteed to be one nano later than any other method.
void	tick() updates now() to current time

Methods inherited from class xapi.time.impl.ImmutableMoment

compareTo, equals, hashCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface xapi.time.service.TimeService

runLater, timestamp

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

now

protected double now

Constructor Detail

AbstractTimeService

public AbstractTimeService()

Method Detail

birth

public double birth()

Description copied from interface: TimeService

the epoch in millis when this TimeService was instantiated

Specified by:

birth in interface TimeService

Returns:

- System startup time.

now

public Moment now()

Specified by:

now in interface TimeService

clone

public Moment clone(Moment moment)

Description copied from interface: TimeService

creates an immutable copy of a moment

Specified by:

clone in interface TimeService

Parameters:

moment - - The moment to copy

Returns:

an ImmutableMoment that == moment

millis

public double millis()

Specified by:

millis in interface Moment

Overrides:

millis in class ImmutableMoment

nowPlusOne

public Moment nowPlusOne()

Description copied from interface: TimeService

Returns a new moment guaranteed to be one nano later than any other method. We use a volatile delta float which we check-and-increment for each call to nowPlusOne(). This is useful if you want to have usable map keys which point to the same millis timeslow, but have atomic "pseudo nano precision" on systems with low resolution timers. This allows you to use a single ordered queue without resorting to buckets to hold items scheduled at the same time. High resolution time services will use correct nano precision, at the cost of synchronizing on calls to System.nanoTime(), to ensure unique timestamps across all calls to the time service.

Specified by:

nowPlusOne in interface TimeService

Returns:

A guaranteed unique timestamp gauranteed later than now() until the next call to tick();

tick

public void tick()

Description copied from interface: TimeService

updates now() to current time

Specified by:

tick in interface TimeService