RFR: 8287134: HttpURLConnection chunked streaming mode doesn't enforce specified size

[Conor Cleary]

On Mon, 23 Jan 2023 09:04:58 GMT, Conor Cleary <ccleary at openjdk.org> wrote:

> ### **Description**
> When using `HttpURLConnection::setChunkedStreamingMode()`, the current documentation does not make it clear that the `chunklen` parameter refers to the amount of bytes sent on the wire per HTTP/1.1 chunk and _not_ the  payload length per chunk. The `chunklen` parameter takes into account the bytes used for the chunk size header, two CRLF characters and the possible payload length inclusively.
> 
> ### **Summary of Changes & Justification**
> The API text has been updated to reflect the actual behavior of the method as described above to avoid a similar bug being submitted in the future and to make it clear what the `chunklen` parameter specifies.
> 
> This change will require a csr.

A CSR will be required to be submitted for this change. I will create this and allow for a review period of this PR before finalizing it.

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

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