Package io.servicetalk.encoding.api.internal

Class HeaderUtils

  • public final class HeaderUtils
extends java.lang.Object

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static ContentCodec encodingFor​(java.util.Collection<ContentCodec> allowedList, java.lang.CharSequence name)
      Returns the ContentCodec that matches the name within the allowedList.
      static ContentCodec negotiateAcceptedEncoding​(java.lang.CharSequence acceptEncodingHeaderValue, java.util.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​(java.util.List<ContentCodec> clientSupportedEncodings, java.util.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 java.lang.Object

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

    • Method Detail

      • negotiateAcceptedEncoding

        @Nullable
public static ContentCodec negotiateAcceptedEncoding​(@Nullable
                                                     java.lang.CharSequence acceptEncodingHeaderValue,
                                                     java.util.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​(java.util.List<ContentCodec> clientSupportedEncodings,
                                                     java.util.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​(java.util.Collection<ContentCodec> allowedList,
                                       @Nullable
                                       java.lang.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.