Package com.oroinc.net
Class TimeTCPClient
java.lang.Object
com.oroinc.net.SocketClient
com.oroinc.net.TimeTCPClient
The TimeTCPClient class is a TCP implementation of a client for the
Time protocol described in RFC 868. To use the class, merely
establish a connection with
connect
and call either getTime() or
getDate() to retrieve the time, then
call disconnect
to close the connection properly.
- Author:
- Daniel F. Savarese
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
The default time port.static final long
The number of seconds between 00:00 1 January 1900 and 00:00 1 January 1970.Fields inherited from class com.oroinc.net.SocketClient
_defaultPort_, _input_, _isConnected_, _output_, _socket_, _socketFactory_, _timeout_, NETASCII_EOL
-
Constructor Summary
Constructors -
Method Summary
Methods inherited from class com.oroinc.net.SocketClient
_connectAction_, connect, connect, connect, connect, connect, connect, disconnect, getDefaultPort, getDefaultTimeout, getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort, getSoLinger, getSoTimeout, getTcpNoDelay, isConnected, setDefaultPort, setDefaultTimeout, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote
-
Field Details
-
DEFAULT_PORT
public static final int DEFAULT_PORTThe default time port. It is set to 37 according to RFC 868.- See Also:
-
SECONDS_1900_TO_1970
public static final long SECONDS_1900_TO_1970The 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:
-
-
Constructor Details
-
TimeTCPClient
public TimeTCPClient()The default TimeTCPClient constructor. It merely sets the default port toDEFAULT_PORT
.
-
-
Method Details
-
getTime
Retrieves the time from the server 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.The server will have closed the connection at this point, so you should call disconnect after calling this method. To retrieve another time, you must initiate another connection with connect before calling
getTime()
again.- Returns:
- The time value retrieved from the server.
- Throws:
IOException
- If an error occurs while fetching the time.
-
getDate
Retrieves the time from the server and returns a Java Date containing the time converted to the local timezone.The server will have closed the connection at this point, so you should call disconnect after calling this method. To retrieve another time, you must initiate another connection with connect before calling
getDate()
again.- Returns:
- A Date value containing the time retrieved from the server converted to the local timezone.
- Throws:
IOException
- If an error occurs while fetching the time.
-