RFR: 8327991: Improve HttpClient documentation with regard to reclaiming resources [v4]

[Jaikiran Pai]

On Wed, 20 Mar 2024 17:42:34 GMT, Daniel Fuchs <dfuchs at openjdk.org> wrote:

>> Please find here a doc-only change that tries to better document how resources allocated by the HttpClient are reclaimed.
>> The `@implNote` in the HttpClient class level API documentation is extended to document what happens if you don't explicitly close the HttpClient. The note is refactored to introduce the notion of streaming or publishing bodies. BodySubscribers and BodyHandlers now have links that link back to the HttpClient API note, as well as identifying methods that return publishing or streaming body implementations.
>
> Daniel Fuchs has updated the pull request incrementally with three additional commits since the last revision:
> 
>  - Update src/java.net.http/share/classes/java/net/http/HttpResponse.java
>    
>    Co-authored-by: Michael McMahon <70538289+Michael-Mc-Mahon at users.noreply.github.com>
>  - Update src/java.net.http/share/classes/java/net/http/HttpResponse.java
>    
>    Co-authored-by: Michael McMahon <70538289+Michael-Mc-Mahon at users.noreply.github.com>
>  - Update src/java.net.http/share/classes/java/net/http/HttpClient.java
>    
>    Co-authored-by: Michael McMahon <70538289+Michael-Mc-Mahon at users.noreply.github.com>

Hello Daniel, the changes look OK to me. package-info.java will need a copyright year update before integrating.

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

Marked as reviewed by jpai (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/18270#pullrequestreview-1952387448