Integrated: 8327991: Improve HttpClient documentation with regard to reclaiming resources

[Daniel Fuchs]

On Wed, 13 Mar 2024 12:25:44 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.

This pull request has now been integrated.

Changeset: 2725405a
Author:    Daniel Fuchs <dfuchs at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/2725405ac9d93761e26812d010d315a48f86071c
Stats:     106 lines in 3 files changed: 75 ins; 2 del; 29 mod

8327991: Improve HttpClient documentation with regard to reclaiming resources

Reviewed-by: michaelm, jpai

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

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