Skip to content

Commit

Permalink
add more information to HttpClient implNote
Browse files Browse the repository at this point in the history
  • Loading branch information
dfuch committed Mar 13, 2024
1 parent c147ef6 commit 0562494
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions src/java.net.http/share/classes/java/net/http/HttpClient.java
Original file line number Diff line number Diff line change
Expand Up @@ -140,8 +140,9 @@
* or publishing {@code BodyHandler} and {@code BodySubscriber}
* implementations} which allow to stream body data back to the caller.
* In order for the resources associated with these streams to be
* reclaimed, a caller must eventually {@linkplain HttpResponse#body()
* obtain these streaming response body} and close, cancel, or
* reclaimed, and for the HTTP request to be considered completed,
* a caller must eventually {@linkplain HttpResponse#body()
* obtain the streaming response body} and close, cancel, or
* read the returned streams to exhaustion. Likewise, a custom
* {@link BodySubscriber} implementation should either {@linkplain
* Subscription#request(long) request} all data until {@link
Expand All @@ -156,7 +157,9 @@
* provide a best effort implementation. Failing to close, cancel, or
* read {@link ##streaming streaming bodies} to exhaustion may stop
* delivery of data and {@linkplain #awaitTermination(Duration) stall an
* orderly shutdown}.
* orderly shutdown}. The {@link #shutdownNow()} method will attempt
* to cancel any such non-completed requests, but may cause
* abrupt termination of any on going operation.
*
* <p id="gc">
* If not {@linkplain ##closing explicitly closed}, the JDK
Expand Down

0 comments on commit 0562494

Please sign in to comment.