Update java doc on ContentLength in requestBody for s3 uploads

[Fred1155]

Motivation and Context

Customers may get partial object puts when they SDK to upload an input stream, but they incorrectly set the content length. This PR improved the documentation surrounding this usage to warn user from inadvertently setting an incorrect Content-Length.

Modifications

Added documentation in

AsyncRequestBody.fromInputStream
AsyncRequestBody.forBlockingInputStream
AsyncRequestBody.forBlockingOutputStream
RequestBody.fromInputStream
RequestBody.fromContentProvider

Testing

Screenshots (if appropriate)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

Checklist

• I have read the CONTRIBUTING document
• Local run of mvn install succeeds
• My code follows the code style of this project
• My change requires a change to the Javadoc documentation
• I have updated the Javadoc documentation accordingly
• I have added tests to cover my changes
• All new and existing tests passed
• I have added a changelog entry. Adding a new entry must be accomplished by running the scripts/new-change script and following the instructions. Commit the new file created by the script in .changes/next-release with your changes.
• My change is to implement 1.11 parity feature and I have updated LaunchChangelog

License

• I confirm that this pull request can be released under the Apache 2 license

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud