src/java.base/share/classes/java/net/DatagramSocket.java

*** 24,33 ****
--- 24,34 ----
   */
  
  package java.net;
  
  import java.io.IOException;
+ import java.io.UncheckedIOException;
  import java.nio.channels.DatagramChannel;
  import java.security.AccessController;
  import java.security.PrivilegedExceptionAction;
  import java.util.Objects;
  import java.util.Set;
*** 496,512 ****
       *
       * @throws SecurityException
       *         if a security manager has been installed and it does
       *         not permit access to the given remote address
       *
       * @see #disconnect
       */
      public void connect(InetAddress address, int port) {
          try {
              connectInternal(address, port);
          } catch (SocketException se) {
!             throw new Error("connect failed", se);
          }
      }
  
      /**
       * Connects this socket to a remote socket address (IP address + port number).
--- 497,517 ----
       *
       * @throws SecurityException
       *         if a security manager has been installed and it does
       *         not permit access to the given remote address
       *
+      * @throws UncheckedIOException
+      *         May be thrown by an implementation if connect fails,
+      *         for example, if the destination address is non-routable
+      *
       * @see #disconnect
       */
      public void connect(InetAddress address, int port) {
          try {
              connectInternal(address, port);
          } catch (SocketException se) {
!             throw new UncheckedIOException("connect failed", se);
          }
      }
  
      /**
       * Connects this socket to a remote socket address (IP address + port number).
*** 543,552 ****
--- 548,565 ----
  
      /**
       * Disconnects the socket. If the socket is closed or not connected,
       * then this method has no effect.
       *
+      * @apiNote If this method throws an UncheckedIOException, the socket
+      * may be left in an unspecified state. It is strongly recommended that
+      * the socket be closed when disconnect fails.
+      *
+      * @throws  UncheckedIOException
+      *          May be thrown by an implementation if it fails to dissolve the
+      *          association and restore the socket to a consistent state.
+      *
       * @see #connect
       */
      public void disconnect() {
          synchronized (this) {
              if (isClosed())