Package net.i2p.util

Class Clock

java.lang.Object
net.i2p.util.Clock
All Implemented Interfaces:
Timestamper.UpdateListener
Direct Known Subclasses:
RouterClock
public class Clock
extends Object
implements Timestamper.UpdateListener
Alternate location for determining the time which takes into account an offset. This offset will ideally be periodically updated so as to serve as the difference between the local computer's current time and the time as known by some reference (such as an NTP synchronized clock). Protected members are used in the subclass RouterClock, which has access to a router's transports (particularly peer clock skews) to second-guess the sanity of clock adjustments.

  • Field Details

  • Constructor Details

  • Method Details

    • getInstance

      public static Clock getInstance()

    • getTimestamper

      public Timestamper getTimestamper()
      This is a dummy, see RouterClock and RouterTimestamper for the real thing

    • getLog

      protected Log getLog()
      we fetch it on demand to avoid circular dependencies (logging uses the clock)

    • setOffset

      public void setOffset​(long offsetMs)
      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.
      Parameters:
      offsetMs - the delta from System.currentTimeMillis() (NOT the delta from now())

    • 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. Warning - overridden in RouterClock
      Parameters:
      offsetMs - the delta from System.currentTimeMillis() (NOT the delta from now())

    • getOffset

      public long getOffset()

    • getUpdatedSuccessfully

      public boolean getUpdatedSuccessfully()

    • setNow

      public void setNow​(long realTime)

    • setNow

      public void setNow​(long realTime, int stratum)
      Warning - overridden in RouterClock
      Specified by:
      setNow in interface Timestamper.UpdateListener
      Parameters:
      stratum - ignored
      Since:
      0.7.12

    • now

      public long now()
      Retrieve the current time synchronized with whatever reference clock is in use.

    • addUpdateListener

      public void addUpdateListener​(Clock.ClockUpdateListener lsnr)

    • removeUpdateListener

      public void removeUpdateListener​(Clock.ClockUpdateListener lsnr)

    • fireOffsetChanged

      protected void fireOffsetChanged​(long delta)