Don't over-allocate in HeapBufferedAsyncEntityConsumer in order to consume the response

[reta]

Description

The HeapBufferedAsyncEntityConsumer over-allocates the response buffer (up to configured limit, by default of 100Mb) in order to consume the response. This may not be an issue in most cases but if there are many requests being sent in parallel, the memory overhead will be noticeable.

This is not a memory leak (all resources are properly closed) but the consequences of over committing the heap buffers.

Related Issues

Closes #9866

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff
• Commit changes are listed out in CHANGELOG.md file (See: Changelog)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/25395/
• CommitID: c696634
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/25396/
• CommitID: 00b69dd
  Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green.
  Is the failure a flaky test unrelated to your change?

[github-actions]

Compatibility status:

Checks if related components are compatible with change 696f412

Incompatible components

Skipped components

Compatible components

Compatible components: [https://github.com/opensearch-project/security.git, https://github.com/opensearch-project/index-management.git, https://github.com/opensearch-project/sql.git, https://github.com/opensearch-project/job-scheduler.git, https://github.com/opensearch-project/observability.git, https://github.com/opensearch-project/k-nn.git, https://github.com/opensearch-project/cross-cluster-replication.git, https://github.com/opensearch-project/performance-analyzer.git, https://github.com/opensearch-project/ml-commons.git, https://github.com/opensearch-project/performance-analyzer-rca.git, https://github.com/opensearch-project/security-analytics.git, https://github.com/opensearch-project/custom-codecs.git, https://github.com/opensearch-project/alerting.git, https://github.com/opensearch-project/anomaly-detection.git, https://github.com/opensearch-project/opensearch-oci-object-storage.git, https://github.com/opensearch-project/asynchronous-search.git, https://github.com/opensearch-project/geospatial.git, https://github.com/opensearch-project/common-utils.git, https://github.com/opensearch-project/reporting.git, https://github.com/opensearch-project/notifications.git, https://github.com/opensearch-project/neural-search.git]

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: UNSTABLE ❕
• TEST FAILURES:

      1 org.opensearch.remotestore.SegmentReplicationUsingRemoteStoreIT.testMultipleShards

• URL: https://build.ci.opensearch.org/job/gradle-check/25397/
• CommitID: 9c7792a
  Please review all flaky tests that succeeded after retry and create an issue if one does not already exist to track the flaky failure.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/25402/
• CommitID: 696f412

[codecov]

Codecov Report

Merging #9993 (696f412) into main (b90a888) will increase coverage by 0.05%.
Report is 1 commits behind head on main.
The diff coverage is 45.45%.

@@             Coverage Diff              @@
##               main    #9993      +/-   ##
============================================
+ Coverage     71.09%   71.14%   +0.05%     
- Complexity    58083    58125      +42     
============================================
  Files          4824     4824              
  Lines        273897   273904       +7     
  Branches      39910    39912       +2     
============================================
+ Hits         194714   194856     +142     
+ Misses        62830    62745      -85     
+ Partials      16353    16303      -50     

Files Changed	Coverage Δ
...dination/UnsafeBootstrapClusterManagerCommand.java	0.00% <0.00%> (ø)
...ch/client/nio/HeapBufferedAsyncEntityConsumer.java	66.66% <71.42%> (+9.09%)	⬆️

... and 496 files with indirect coverage changes