org.spf4j.net

Class SntpClient

java.lang.Object

org.spf4j.net.SntpClient

public final class SntpClient
extends Object

Simple NTP client. Inspired by Android Sntp client. For how to use, see SntpClientTest.java. https://tools.ietf.org/html/rfc1361

Author:

zoly

Method Summary

Modifier and Type	Method and Description
static Timing	requestTime(InetAddress address, int port, long deadlineNanos) Get NTP time.
static Timing	requestTime(String host, int timeoutMillis)
static Timing	requestTime(String host, int port, int timeoutMillis)
static Timing	requestTime(String host, int port, long deadlineNanos) Get NTP time.
static Timing	requestTimeHA(int timeoutMillis, int ntpResponseTimeoutMillis, int port, InetAddress... hosts)
static Timing	requestTimeHA(int timeoutMillis, int ntpResponseTimeoutMillis, int port, String... hosts)
static Timing	requestTimeHA(int timeoutMillis, int ntpResponseTimeoutMillis, String... hosts) Request NTP time with retries.
static Timing	requestTimeHA(int timeoutMillis, String... hosts)

Methods inherited from class java.lang.Object

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

Method Detail

requestTimeHA

public static Timing requestTimeHA(int timeoutMillis,
                                   String... hosts)
                            throws IOException,
                                   InterruptedException,
                                   TimeoutException

Throws:

IOException

InterruptedException

TimeoutException

requestTimeHA

public static Timing requestTimeHA(int timeoutMillis,
                                   int ntpResponseTimeoutMillis,
                                   String... hosts)
                            throws IOException,
                                   InterruptedException,
                                   TimeoutException

Request NTP time with retries.

Parameters:

hosts - NTP server hosts.

timeoutMillis - Max time to attempt to get NTP time

ntpResponseTimeoutMillis - the time after which if we do not receive a response from the NTP server, we consider the call failed (and will retry until timeoutMillis.

Returns:

Ntp timing info.

Throws:

IOException - - thrown in case of time server connectivity issues.

InterruptedException - - thrown if exec interrupted.

TimeoutException

requestTimeHA

public static Timing requestTimeHA(int timeoutMillis,
                                   int ntpResponseTimeoutMillis,
                                   int port,
                                   String... hosts)
                            throws IOException,
                                   InterruptedException,
                                   TimeoutException

Throws:

IOException

InterruptedException

TimeoutException

requestTimeHA

public static Timing requestTimeHA(int timeoutMillis,
                                   int ntpResponseTimeoutMillis,
                                   int port,
                                   InetAddress... hosts)
                            throws IOException,
                                   InterruptedException,
                                   TimeoutException

Throws:

IOException

InterruptedException

TimeoutException

requestTime

public static Timing requestTime(String host,
                                 int timeoutMillis)
                          throws IOException

Throws:

IOException

requestTime

public static Timing requestTime(String host,
                                 int port,
                                 int timeoutMillis)
                          throws IOException

Throws:

IOException

requestTime

public static Timing requestTime(String host,
                                 int port,
                                 long deadlineNanos)
                          throws IOException

Get NTP time.

Parameters:

host - - NTP server host name.

timeoutMillis - - the socket timeout.

Returns:

- NTP server timing info.

Throws:

IOException - - thrown in case of time server connectivity issues.

requestTime

public static Timing requestTime(InetAddress address,
                                 int port,
                                 long deadlineNanos)
                          throws IOException

Get NTP time.

Parameters:

address - - NTP server addr.

timeoutMillis - - the socket timeout.

Returns:

- NTP server timing info.

Throws:

IOException - - thrown in case of time server connectivity issues.