[Remote Store] Support to emit multiple streams for a file content each responsible for processing a specific part of the file

[raghuvanshraj]

Description

• Offset based InputStream extensions to emit stream from a specific part of a file, which starts reading from a specific position and ensures that maximum length of content read doesn't exceed a specified limit. OffsetRangeFileInputStream achieves this for File objects, while OffsetRangeIndexInputStream achieves this for lucene's IndexInput construct
• RemoteTransferContainer has utilities to open streams to specific parts of the file based on the type as mentioned in the previous point. It also manages post upload tasks by implementing an UploadFinalizer.
• ResettableCheckedInputStream allows for individual parts to be reset through mark and reset in the event of upload failures

Issues Resolved

• [Remote Store] Support to emit multiple streams for a file content each responsible for processing a specific part of the file #6980

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: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/13388/
• CommitID: 5b252f0

[codecov-commenter]

Codecov Report

Merging #6977 (5b252f0) into main (1856090) will decrease coverage by 0.06%.
The diff coverage is 53.14%.

📣 This organization is not using Codecov’s GitHub App Integration. We recommend you install it so Codecov can continue to function properly for your repositories. Learn more

@@             Coverage Diff              @@
##               main    #6977      +/-   ##
============================================
- Coverage     70.71%   70.65%   -0.06%     
+ Complexity    59261    59249      -12     
============================================
  Files          4813     4822       +9     
  Lines        283767   283974     +207     
  Branches      40919    40935      +16     
============================================
- Hits         200656   200637      -19     
- Misses        66645    66882     +237     
+ Partials      16466    16455      -11     

Impacted Files	Coverage Δ
...ch/common/blobstore/stream/write/WriteContext.java	0.00% <0.00%> (ø)
.../transfer/stream/ResettableCheckedInputStream.java	32.14% <32.14%> (ø)
...re/transfer/stream/OffsetRangeFileInputStream.java	34.88% <34.88%> (ø)
...e/transfer/stream/OffsetRangeIndexInputStream.java	53.33% <53.33%> (ø)
...on/blobstore/transfer/RemoteTransferContainer.java	65.43% <65.43%> (ø)
...er/src/main/java/org/opensearch/common/Stream.java	87.50% <87.50%> (ø)
...ain/java/org/opensearch/common/StreamProvider.java	100.00% <100.00%> (ø)
...nsearch/common/blobstore/stream/StreamContext.java	100.00% <100.00%> (ø)
...h/common/blobstore/stream/write/WritePriority.java	100.00% <100.00%> (ø)

... and 479 files with indirect coverage changes

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/13395/
• CommitID: f6dcb01
  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/13397/
• CommitID: 68fef72
  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/13470/
• CommitID: f1f03c7
  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/13496/
• CommitID: 9dbf037
  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?