io.servicetalk.encoding.api.internal

Class HeaderUtils

Object

HeaderUtils

public final class HeaderUtils
extends Object

Method Summary

Modifier and Type	Method and Description
static ContentCodec	encodingFor(Collection<ContentCodec> allowedList, CharSequence name) Returns the ContentCodec that matches the name within the allowedList.
static ContentCodec	negotiateAcceptedEncoding(CharSequence acceptEncodingHeaderValue, List<ContentCodec> serverSupportedEncodings) Establish a commonly accepted encoding between server and client, according to the supported-encodings on the server side and the 'Accepted-Encoding' incoming header on the request.
static ContentCodec	negotiateAcceptedEncoding(List<ContentCodec> clientSupportedEncodings, List<ContentCodec> serverSupportedEncodings) Establish a commonly accepted encoding between server and client, according to the supported-encodings on the server side and the incoming header on the request.

Methods inherited from class Object

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

Method Detail

negotiateAcceptedEncoding

@Nullable
public static ContentCodec negotiateAcceptedEncoding(@Nullable
                                                               CharSequence acceptEncodingHeaderValue,
                                                               List<ContentCodec> serverSupportedEncodings)

Establish a commonly accepted encoding between server and client, according to the supported-encodings on the server side and the 'Accepted-Encoding' incoming header on the request.

If no supported encodings are configured then the result is always null If no accepted encodings are present in the request then the result is always null In all other cases, the first matching encoding (that is NOT Identity.identity()) is preferred, otherwise null is returned.

Parameters:

acceptEncodingHeaderValue - The accept encoding header value.

serverSupportedEncodings - The server supported codings as configured.

Returns:

The ContentCodec that satisfies both client and server needs, null if none found or matched to Identity.identity()

negotiateAcceptedEncoding

@Nullable
public static ContentCodec negotiateAcceptedEncoding(List<ContentCodec> clientSupportedEncodings,
                                                               List<ContentCodec> serverSupportedEncodings)

Establish a commonly accepted encoding between server and client, according to the supported-encodings on the server side and the incoming header on the request.

If no supported encodings are passed then the result is always null Otherwise, the first matching encoding (that is NOT Identity.identity()) is preferred, or null is returned.

Parameters:

clientSupportedEncodings - The client supported codings as found in the HTTP header.

serverSupportedEncodings - The server supported codings as configured.

Returns:

The ContentCodec that satisfies both client and server needs, null if none found or matched to Identity.identity()

encodingFor

@Nullable
public static ContentCodec encodingFor(Collection<ContentCodec> allowedList,
                                                 @Nullable
                                                 CharSequence name)

Returns the ContentCodec that matches the name within the allowedList. if name is null or empty it results in null . If name is 'identity' this will always result in Identity.identity() regardless of its presence in the allowedList.

Parameters:

allowedList - the source list to find a matching codec from.

name - the codec name used for the equality predicate.

Returns:

a codec from the allowed-list that name matches the name.