Field Detail

• DEFAULT_STRATUM

  public static final int DEFAULT_STRATUM

  DEFAULT_STRATUM.

  See Also:

  Constant Field Values

Constructor Detail

• RouterClock

  public RouterClock(RouterContext context)

  Does not start. Caller MUST call start()

Method Detail

• addShiftListener

  public void addShiftListener(RouterClock.ClockShiftListener lsnr)

  Add a listener to be notified of massive system clock shifts. These are shifts of one minute or more.

  Parameters:

  lsnr - the listener to add

• getTimestamper

  public Timestamper getTimestamper()

  Get the timestamper used for time synchronization.

  Overrides:

  getTimestamper in class Clock

  Returns:

  the RouterTimestamper instance

• now

  public long now()

  Retrieve the current time synchronized with whatever reference clock is in use. Do really simple clock slewing, like NTP but without jitter prevention. Slew the clock toward the desired offset, but only up to a maximum slew rate, and never let the clock go backwards because of slewing. Take care to only access the volatile variables once for speed and to avoid having another thread change them This is called about a zillion times a second, so we can do the slewing right here rather than in some separate thread to keep it simple. Avoiding backwards clocks when updating in a thread would be hard too.

  Overrides:

  now in class Clock

  Returns:

  the current synchronized time in milliseconds

• removeShiftListener

  public void removeShiftListener(RouterClock.ClockShiftListener lsnr)

  Remove a clock shift listener.

  Parameters:

  lsnr - the listener to remove

• setNow

  public void setNow(long realTime,
                     int stratum)

  Set the current time, used by the timestamper when synchronizing.

  Specified by:

  setNow in interface Timestamper.UpdateListener

  Overrides:

  setNow in class Clock

  Parameters:

  realTime - the current time from the time source

  stratum - the stratum level

• setOffset

  public void setOffset(long offsetMs,
                        boolean force)

  Specify how far away from the "correct" time the computer is - a positive value means that the system time is slow, while a negative value means the system time is fast.

  Overrides:

  setOffset in class Clock

  Parameters:

  offsetMs - the delta from System.currentTimeMillis() (NOT the delta from now())

  force - if true, bypass all sanity checks

• start

  public void start()

  Start the router clock and its associated timestamper. The timestamper will begin synchronizing with NTP or peer time sources.