xapi.jre.time

Class JreTimeServiceHighPrecision

java.lang.Object

xapi.time.impl.ImmutableMoment

xapi.time.impl.AbstractTimeService

xapi.time.impl.TimeServiceDefault

xapi.jre.time.JreTimeServiceHighPrecision

All Implemented Interfaces:

Serializable, Comparable<Moment>, Moment, TimeService

@SingletonOverride(implFor=TimeService.class,
                   priority=-2147483646)
public class JreTimeServiceHighPrecision
extends TimeServiceDefault

See Also:

Serialized Form

Field Summary

Fields inherited from class xapi.time.impl.AbstractTimeService

now

Fields inherited from interface xapi.time.service.TimeService

milli_to_nano, second_to_nano

Constructor Summary

Constructors

Constructor and Description
JreTimeServiceHighPrecision()

Method Summary

Modifier and Type	Method and Description
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
String	timestamp()

Methods inherited from class xapi.time.impl.TimeServiceDefault

runLater

Methods inherited from class xapi.time.impl.AbstractTimeService

birth, clone

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 java.lang.Comparable

compareTo

Constructor Detail

JreTimeServiceHighPrecision

public JreTimeServiceHighPrecision()

Method Detail

millis

public double millis()

Specified by:

millis in interface Moment

Overrides:

millis in class AbstractTimeService

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

Overrides:

nowPlusOne in class AbstractTimeService

Returns:

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

now

public Moment now()

Specified by:

now in interface TimeService

Overrides:

now in class AbstractTimeService

tick

public void tick()

Description copied from interface: TimeService

updates now() to current time

Specified by:

tick in interface TimeService

Overrides:

tick in class AbstractTimeService

timestamp

public String timestamp()

Specified by:

timestamp in interface TimeService

Overrides:

timestamp in class TimeServiceDefault

Returns:

An ISO-8601 compliant timestamp: yyyy-MM-dd'T'HH:mm.sssZ