Package org.apache.commons.net.daytime

# Class DaytimeUDPClient

java.lang.Object
org.apache.commons.net.DatagramSocketClient
org.apache.commons.net.daytime.DaytimeUDPClient

All Implemented Interfaces:
  `AutoCloseable`

public final class DaytimeUDPClient extends DatagramSocketClient
The DaytimeUDPClient class is a UDP implementation of a client for the Daytime protocol described in RFC 867. To use the class, merely open a local datagram socket with `open` and call `getTime` to retrieve the daytime string, then call `close` to close the connection properly. Unlike `DaytimeTCPClient`, successive calls to `getTime` are permitted without re-establishing a connection. That is because UDP is a connectionless protocol and the Daytime protocol is stateless.

See Also:
  - `DaytimeTCPClient`

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final int`
  `DEFAULT_PORT`
  The default daytime port.

  ### Fields inherited from class org.apache.commons.net.DatagramSocketClient

  `_isOpen_, _socket_, _socketFactory_, _timeout_`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `DaytimeUDPClient()`
  Constructs a new instance.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `String`
  `getTime(InetAddress host)`
  Gets the time string from the specified server and port and returns it.
  `String`
  `getTime(InetAddress host, int port)`
  Gets the time string from the specified server and port and returns it.

  ### Methods inherited from class org.apache.commons.net.DatagramSocketClient

  `checkOpen, close, getCharset, getCharsetName, getDefaultTimeout, getLocalAddress, getLocalPort, getSoTimeout, getSoTimeoutDuration, isOpen, open, open, open, setCharset, setDatagramSocketFactory, setDefaultTimeout, setDefaultTimeout, setSoTimeout, setSoTimeout`

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### DEFAULT_PORT

    public static final int DEFAULT_PORT
    The default daytime port. It is set to 13 according to RFC 867.
    See Also:
      - Constant Field Values

- ## Constructor Details

  - ### DaytimeUDPClient

    public DaytimeUDPClient()
    Constructs a new instance.

- ## Method Details

  - ### getTime

    public String getTime(InetAddress host) throws IOException
    Gets the time string from the specified server and port and returns it.

    Shorthand for `getTime(host, DaytimeUDPClient.DEFAULT_PORT);`

    Parameters:
      `host` - the host
    Returns:
      the time
    Throws:
      `IOException` - on error

  - ### getTime

    public String getTime(InetAddress host, int port) throws IOException
    Gets the time string from the specified server and port and returns it.
    Parameters:
      `host` - The address of the server.
      `port` - The port of the service.
    Returns:
      The time string.
    Throws:
      `IOException` - If an error occurs while retrieving the time.