add disableGzipContent option for create from InputStream

[nblair]

Is your feature request related to a problem? Please describe.

I have a use case that necessitates using the Storage/Bucket write method variants with InputStream arguments. The inputs for my use case to store in Cloud Storage are:

• predominantly already compressed,
• have a wide range of file sizes, from a few KB to GB+,
• we don't always know the size in advance.

Describe the solution you'd like

Given that our content is already compressed, I would prefer to avoid spending the CPU time on compressing the content again en route to the Bucket.

Describe alternatives you've considered

We have used the byte[] variants, with BlobTargetOption.disableGzipContent and the Compose request. This is suitable but leaves us with a tuning challenge:

• Buffering these streams into memory (byte[] chunks) requires additional heap space be available
• Compose is limited to only 32 chunks. If the file content we intend to store is far larger than 32 * bufferSize, we will upload 31 small sized chunks and 1 large chunk that we have to use the InputStream variant for anyways, and pay the additional overhead of gzip compression.

Additional context

I have done some exploration and it appears that the values on the BlobWriteOption (used on InputStream variants) and BlobTargetOption (used on byte[] variants) enums both are translated into StorageRpc.Option. I have a small contribution to offer in the form of a pull request to follow.

Fixes #36; ported from googleapis/google-cloud-java#7057

[codecov]

Codecov Report

Merging #82 into master will increase coverage by 0.01%.
The diff coverage is 100%.

@@ Coverage Diff @@ ## master #82 +/- ## ============================================ + Coverage 63.3% 63.32% +0.01%  Complexity 528 528 ============================================ Files 30 30 Lines 4720 4722 +2 Branches 450 450 ============================================ + Hits 2988 2990 +2  Misses 1571 1571 Partials 161 161

Impacted Files	Coverage Δ	Complexity Δ
...rc/main/java/com/google/cloud/storage/Storage.java	80.16% <100%> (+0.1%)	0 <0> (ø)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b93106b...183d0c6. Read the comment docs.

[nblair]

Hi there! I'm curious if you have any feedback or questions on the idea and the approach?

Thanks in advance!

[frankyn]

Change LGTM, pending tests to finish and will merge. Thank you for your contribution @nblair!

[nblair]

Thanks for your time @frankyn - cheers!