io.servicetalk.http.api

Class ContentCodingHttpServiceFilter

Object

ContentCodingHttpServiceFilter

All Implemented Interfaces:

HttpExecutionStrategyInfluencer, StreamingHttpServiceFilterFactory, ExecutionStrategyInfluencer<HttpExecutionStrategy>

Deprecated.

Use ContentEncodingHttpServiceFilter.

@Deprecated
public final class ContentCodingHttpServiceFilter
extends Object
implements StreamingHttpServiceFilterFactory

A StreamingHttpService that adds encoding / decoding functionality for responses and requests respectively, as these are specified by the spec Content-Encoding.

Append this filter before others that are expected to see compressed content for this request/response, and after other filters that expect to see/manipulate the original payload.

Constructor Summary

Constructors

Constructor and Description
ContentCodingHttpServiceFilter(List<ContentCodec> supportedCodings) Deprecated. Enable support of the provided encodings for this server's responses.
ContentCodingHttpServiceFilter(List<ContentCodec> supportedRequestCodings, List<ContentCodec> supportedResponseCodings) Deprecated. Enable support of the provided encodings for both client requests and server responses.

Method Summary

Modifier and Type	Method and Description
StreamingHttpServiceFilter	create(StreamingHttpService service) Deprecated. Create a StreamingHttpServiceFilter using the provided StreamingHttpService.
HttpExecutionStrategy	requiredOffloads() Deprecated.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface HttpExecutionStrategyInfluencer

defaultStreamingInfluencer, influenceStrategy

Constructor Detail

ContentCodingHttpServiceFilter

public ContentCodingHttpServiceFilter(List<ContentCodec> supportedCodings)

Deprecated.

Enable support of the provided encodings for this server's responses. The encodings will be used for server responses compression where enabled and matched with client ones.

Client requests that have compressed payloads will be rejected. To enable support of compressed requests, see ContentCodingHttpServiceFilter(List, List).

Parameters:

supportedCodings - the codecs used to compress responses when allowed.

ContentCodingHttpServiceFilter

public ContentCodingHttpServiceFilter(List<ContentCodec> supportedRequestCodings,
                                      List<ContentCodec> supportedResponseCodings)

Deprecated.

Enable support of the provided encodings for both client requests and server responses. The encodings can differ for requests and responses, allowing a server that supports different compressions for requests and different ones for responses.

To disable support of compressed requests use an Collections.emptyList() for the supportedRequestCodings param or use ContentCodingHttpServiceFilter(List) constructor instead.

The order of the codecs provided, affect selection priority alongside the order of the incoming accept-encoding header from the client.

Parameters:

supportedRequestCodings - the codecs used to decompress client requests if compressed.

supportedResponseCodings - the codecs used to compress server responses if client accepts them.

Method Detail

create

public StreamingHttpServiceFilter create(StreamingHttpService service)

Deprecated.

Description copied from interface: StreamingHttpServiceFilterFactory

Create a StreamingHttpServiceFilter using the provided StreamingHttpService.

Specified by:

create in interface StreamingHttpServiceFilterFactory

Parameters:

service - StreamingHttpService to filter

Returns:

StreamingHttpServiceFilter using the provided StreamingHttpService.

requiredOffloads

public HttpExecutionStrategy requiredOffloads()

Deprecated.

Description copied from interface: HttpExecutionStrategyInfluencer

The provided default implementation requests offloading of all operations. Implementations that require no offloading should be careful to return HttpExecutionStrategies.offloadNone() rather than HttpExecutionStrategies.offloadNever(). Implementations should avoid returning HttpExecutionStrategies.defaultStrategy(), instead returning the strategy they require or HttpExecutionStrategies.offloadAll() if offloading for all paths is required (safe default).

Specified by:

requiredOffloads in interface HttpExecutionStrategyInfluencer

Specified by:

requiredOffloads in interface ExecutionStrategyInfluencer<HttpExecutionStrategy>