RFR: 8343791: Socket.connect API should document whether the socket will be closed when hostname resolution fails or another error occurs [v14]

[Volkan Yazıcı]

> This PR, addressing 8343791, changes `Socket::connect()` methods to close the `Socket` in the event that the connection cannot be established, the timeout expires before the connection is established, or the socket address is unresolved.
> 
> `tier3` tests pass against the 9f00f61d3b7fa42a5e23a04f80bb4bb1a2076ef2.

Volkan Yazıcı has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 19 commits:

 - Merge remote-tracking branch 'upstream/master' into Socket-CloseOnFailure-8343791
 - Reflect behavioral changes to `SocketAdaptor`
 - Improve variable names
 - Improve naming in tests
 - Handle `SocketTimeoutException` in `NioSocketImpl::connect()`
 - Revert `UHE` message change in `NioSocketImpl`
 - Remove self-reference guard in `closeSuppressingExceptions()`
 - Add back incorrectly removed `SocketTimeoutException` Javadoc
 - Remove unused `port` variable
 - Replace `UnknownHostException exception` with `var uhe`
 - ... and 9 more: https://git.openjdk.org/jdk/compare/9576546b...423a78c3

-------------

Changes: https://git.openjdk.org/jdk/pull/22160/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=22160&range=13
  Stats: 464 lines in 6 files changed: 423 ins; 33 del; 8 mod
  Patch: https://git.openjdk.org/jdk/pull/22160.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/22160/head:pull/22160

PR: https://git.openjdk.org/jdk/pull/22160