java.lang.Object
org.apache.commons.net.DatagramSocketClient
org.apache.commons.net.TimeUDPClient
- public final class TimeUDPClient
- extends DatagramSocketClient
The TimeUDPClient class is a UDP implementation of a client for the
Time protocol described in RFC 868. To use the class, merely
open a local datagram socket with
open 55
and call getTime 55 or
getDate 55 to retrieve the time. Then call
close 55
to close the connection properly. Unlike
TimeTCPClient,
successive calls to getTime 55 or
getDate 55 are permitted
without re-establishing a connection. That is because UDP is a
connectionless protocol and the Time protocol is stateless.
| Methods inherited from class org.apache.commons.net.DatagramSocketClient |
close, getDefaultTimeout, getLocalAddress, getLocalPort, getSoTimeout, isOpen, open, open, open, setDatagramSocketFactory, setDefaultTimeout, setSoTimeout |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
DEFAULT_PORT
public static final int DEFAULT_PORT
- The default time port. It is set to 37 according to RFC 868.
- See Also:
- Constant Field Values
SECONDS_1900_TO_1970
public static final long SECONDS_1900_TO_1970
- The number of seconds between 00:00 1 January 1900 and
00:00 1 January 1970. This value can be useful for converting
time values to other formats.
- See Also:
- Constant Field Values
__dummyData
private byte[] __dummyData
__timeData
private byte[] __timeData
TimeUDPClient
public TimeUDPClient()
getTime
public long getTime(java.net.InetAddress host,
int port)
throws java.io.IOException
- Retrieves the time from the specified server and port and
returns it. The time is the number of seconds since
00:00 (midnight) 1 January 1900 GMT, as specified by RFC 868.
This method reads the raw 32-bit big-endian
unsigned integer from the server, converts it to a Java long, and
returns the value.
getTime
public long getTime(java.net.InetAddress host)
throws java.io.IOException
- Same as
getTime(host, DEFAULT_PORT);
getDate
public java.util.Date getDate(java.net.InetAddress host,
int port)
throws java.io.IOException
- Retrieves the time from the server and returns a Java Date
containing the time converted to the local timezone.
getDate
public java.util.Date getDate(java.net.InetAddress host)
throws java.io.IOException
- Same as
getTime(host, DEFAULT_PORT);