On Sat, 20 Jul 2024 08:22:20 GMT, Alan Bateman <al...@openjdk.org> wrote:

>> Can I please get a review of this change which updates the specification of 
>> a few methods in `java.net.Socket` and `java.net.ServerSocket` classes to 
>> specify the `IOException` that the implementation currently already throws?
>> 
>> This is merely a doc update and doesn't change the implementation.
>> 
>> Given that these exceptions can now be asserted, a new jtreg test has been 
>> introduced to verify the exceptions thrown from these APIs. The test passes. 
>> tier testing is currently in progress. I'll open a CSR shortly.
>
> src/java.base/share/classes/java/net/ServerSocket.java line 521:
> 
>> 519:      *
>> 520:      * @throws     IOException  if an I/O error occurs when waiting for 
>> a
>> 521:      *               connection, or if the socket isn't bound or is 
>> already closed.
> 
> Can you check the existing text as I think it uses "not bound" rather than 
> "isn't bound".

Also "already close" might be a bit inconsistent with the existing API docs 
too, can you check as I think we use  "is closed" in most places.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20268#discussion_r1685320246

Reply via email to