RouterTimestamper (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.time.Timestamper
- - net.i2p.router.time.RouterTimestamper

All Implemented Interfaces:
Runnable
```
public class RouterTimestamper
extends Timestamper
```
Periodically query a series of NTP servers and update any associated listeners. It tries the NTP servers in order, contacting them using SNTP (UDP port 123).

Nested Class Summary
- Nested classes/interfaces inherited from class net.i2p.time.Timestamper
  Timestamper.UpdateListener

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`PROP_CONCURRING_SERVERS` PROP_CONCURRING_SERVERS.
`static String`	`PROP_DISABLED` PROP_DISABLED.
`static String`	`PROP_IP_COUNTRY` PROP_IP_COUNTRY.
`static String`	`PROP_QUERY_FREQUENCY` PROP_QUERY_FREQUENCY.
`static String`	`PROP_SERVER_LIST` PROP_SERVER_LIST.

Constructor Summary

Constructors
Constructor and Description
`RouterTimestamper(I2PAppContext ctx)` Does not start.
`RouterTimestamper(I2PAppContext ctx, Timestamper.UpdateListener lsnr)` Does not start.
`RouterTimestamper(I2PAppContext ctx, Timestamper.UpdateListener lsnr, boolean daemon)` Does not start.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addListener(Timestamper.UpdateListener lsnr)` Register a listener to be notified of time updates.
`boolean`	`getIsDisabled()` Whether NTP is disabled.
`Timestamper.UpdateListener`	`getListener(int index)` Time update listener at the given index.
`int`	`getListenerCount()` Number of registered time update listeners.
`int`	`getQueryFrequencyMs()` How often to query the NTP servers, in ms.
`String`	`getServer(int index)` NTP server at the given index in the configured list.
`int`	`getServerCount()` Number of NTP servers in the configured list.
`void`	`removeListener(Timestamper.UpdateListener lsnr)` Unregister a listener from time update notifications.
`void`	`run()` Run the main SNTP query loop, updating the time periodically.
`void`	`startTimestamper()` Start the SNTP query thread, unless disabled or already initialized.
`void`	`timestampNow()` Update the time immediately.
`void`	`waitForInitialization()` Wait until the initial time synchronization completes, or the timeout is reached.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PROP_CONCURRING_SERVERS
```
public static final String PROP_CONCURRING_SERVERS
```
    PROP_CONCURRING_SERVERS.
    See Also:
    Constant Field Values
  - PROP_DISABLED
```
public static final String PROP_DISABLED
```
    PROP_DISABLED.
    See Also:
    Constant Field Values
  - PROP_IP_COUNTRY
```
public static final String PROP_IP_COUNTRY
```
    PROP_IP_COUNTRY.
    See Also:
    Constant Field Values
  - PROP_QUERY_FREQUENCY
```
public static final String PROP_QUERY_FREQUENCY
```
    PROP_QUERY_FREQUENCY.
    See Also:
    Constant Field Values
  - PROP_SERVER_LIST
```
public static final String PROP_SERVER_LIST
```
    PROP_SERVER_LIST.
    See Also:
    Constant Field Values
- Constructor Detail
  - RouterTimestamper
```
public RouterTimestamper(I2PAppContext ctx)
```
    Does not start. Caller MUST call startTimestamper()
  - RouterTimestamper
```
public RouterTimestamper(I2PAppContext ctx,
                         Timestamper.UpdateListener lsnr)
```
    Does not start. Caller MUST call startTimestamper()
  - RouterTimestamper
```
public RouterTimestamper(I2PAppContext ctx,
                         Timestamper.UpdateListener lsnr,
                         boolean daemon)
```
    Does not start. Caller MUST call startTimestamper()
- Method Detail
  - addListener
```
public void addListener(Timestamper.UpdateListener lsnr)
```
    Register a listener to be notified of time updates.
  - getIsDisabled
```
public boolean getIsDisabled()
```
    Whether NTP is disabled.
    Returns:
    whether disabled
  - getListener
```
public Timestamper.UpdateListener getListener(int index)
```
    Time update listener at the given index.
    Returns:
    the listener
  - getListenerCount
```
public int getListenerCount()
```
    Number of registered time update listeners.
    Returns:
    the listener count
  - getQueryFrequencyMs
```
public int getQueryFrequencyMs()
```
    How often to query the NTP servers, in ms.
    Returns:
    the query frequency ms
  - getServer
```
public String getServer(int index)
```
    NTP server at the given index in the configured list.
    Returns:
    the server
  - getServerCount
```
public int getServerCount()
```
    Number of NTP servers in the configured list.
    Returns:
    the server count
  - removeListener
```
public void removeListener(Timestamper.UpdateListener lsnr)
```
    Unregister a listener from time update notifications.
  - run
```
public void run()
```
    Run the main SNTP query loop, updating the time periodically.
    Specified by:
    run in interface Runnable
    Overrides:
    run in class Timestamper
  - startTimestamper
```
public void startTimestamper()
```
    Start the SNTP query thread, unless disabled or already initialized.
  - timestampNow
```
public void timestampNow()
```
    Update the time immediately.
    Overrides:
    timestampNow in class Timestamper
  - waitForInitialization
```
public void waitForInitialization()
```
    Wait until the initial time synchronization completes, or the timeout is reached.
    Overrides:
    waitForInitialization in class Timestamper

Class RouterTimestamper

Nested Class Summary

Nested classes/interfaces inherited from class net.i2p.time.Timestamper

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

PROP_CONCURRING_SERVERS

PROP_DISABLED

PROP_IP_COUNTRY

PROP_QUERY_FREQUENCY

PROP_SERVER_LIST

Constructor Detail

RouterTimestamper

RouterTimestamper

RouterTimestamper

Method Detail

addListener

getIsDisabled

getListener

getListenerCount

getQueryFrequencyMs

getServer

getServerCount

removeListener

run

startTimestamper

timestampNow

waitForInitialization