feat: allow explicitly enabling/disabling of encodings in EncodingService

[schiemon]

Motivation

From #6390:

We encountered an issue where the deflate encoding algorithm used by EncodingService is incompatible with our VPN infrastructure, causing connection failures. Currently, there is no way to disable or exclude specific encoding algorithms.

Modifications

• Moved StreamEncoderFactory, StreamEncoderFactories, and SnappyFramedOutputStream from com.linecorp.armeria.internal.common.encoding to com.linecorp.armeria.common.encoding to enable their use in EncoderService and related components.

• Modified HttpEncoders.determineEncoder to accept a map of StreamEncoderFactorys that defines the available StreamEncoderFactory instances. The * wildcard now only refers to factories present in the provided map.

• Added the following methods to EncodingService:

  Function<? super HttpService, EncodingService>
      newDecorator(Iterable<? extends StreamEncoderFactory> encoderFactories)
  Function<? super HttpService, EncodingService>
      newDecorator(StreamEncoderFactory... encoderFactories) 

  These methods allow setting the factories that EncodingService will pass to HttpEncoder when determining the appropriate factory from the Accept-Encoding header.

• Added following methods to EncoderServiceBuilder:

EncodingServiceBuilder encoderFactories(Iterable<? extends StreamEncoderFactory> encoderFactories)
EncodingServiceBuilder encoderFactories(StreamEncoderFactory... encoderFactories)

Result

Closes #6390. Users can now explicitly control which StreamEncoderFactory instances EncodingService will use for each Accept-Encoding header value.

Usage example:

EncodingService
    .builder()
    .encoderFactories(
        // handles "gzip"
        StreamEncoderFactories.GZIP,
        // handles "deflate"
        StreamEncoderFactories.DEFLATE,
        // handles "br"
        new CustomBrotliEncoderFactory()
     )
    .build(delegate);

[github-actions]

🔍 Build Scan® (commit: 477799e)

Job name	Status	Build Scan®
build-ubicloud-standard-16-jdk-8	✅	https://ge.armeria.dev/s/naxixtch6xskq
build-ubicloud-standard-16-jdk-21-snapshot-blockhound	✅	https://ge.armeria.dev/s/b5ssd73tjel2q
build-ubicloud-standard-16-jdk-17-min-java-17-coverage	✅	https://ge.armeria.dev/s/qgraf3e6swuam
build-ubicloud-standard-16-jdk-17-min-java-11	✅	https://ge.armeria.dev/s/jfb7guqmgl73i
build-ubicloud-standard-16-jdk-17-leak	✅	https://ge.armeria.dev/s/rt3f66uizaktu
build-ubicloud-standard-16-jdk-11	✅	https://ge.armeria.dev/s/iqibhbplaxjbo
build-macos-latest-jdk-21	❌ (failure)	https://ge.armeria.dev/s/ykzx4isiy6dv6

[codecov]

Codecov Report

❌ Patch coverage is 77.77778% with 12 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.11%. Comparing base (8150425) to head (477799e).
⚠️ Report is 203 commits behind head on main.

Files with missing lines	Patch %	Lines
...ecorp/armeria/server/encoding/EncodingService.java	45.45%	6 Missing ⚠️
...linecorp/armeria/server/encoding/HttpEncoders.java	86.66%	3 Missing and 1 partial ⚠️
...rmeria/common/encoding/StreamEncoderFactories.java	60.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #6398      +/-   ##
============================================
- Coverage     74.46%   74.11%   -0.36%     
- Complexity    22234    23005     +771     
============================================
  Files          1963     2062      +99     
  Lines         82437    86154    +3717     
  Branches      10764    11310     +546     
============================================
+ Hits          61385    63851    +2466     
- Misses        15918    16890     +972     
- Partials       5134     5413     +279     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[schiemon]

Not sure if we need it:

https://github.com/schiemon/armeria/blob/879d83eb2192732257e50ba156b054ab86d9ce58/core/src/main/java/com/linecorp/armeria/server/encoding/HttpEncoders.java#L36-L39

[ikhoon]

Not sure if we need it:

If tests are not broken, we may remove it.

[ikhoon]

Overall looks good

[minwoox]

Looks great, thanks!

[schiemon]

@ikhoon May I ask for another review to get a ✅ ? :)

[ikhoon]

Thanks! 👍👍