org.apache.hc.client5.http.impl

Class AlpnHeaderSupport

java.lang.Object

org.apache.hc.client5.http.impl.AlpnHeaderSupport

@Contract(threading=IMMUTABLE)
 @Internal
public final class AlpnHeaderSupport
extends Object

Codec for the HTTP ALPN header field (RFC 7639).

Since:

5.7

Method Summary

Modifier and Type	Method and Description
static String	decodeId(String token) Decodes a percent-encoded token to a raw protocol ID using UTF-8.
static String	encodeId(String id) Encodes a single raw protocol ID to canonical token form using the HTTP token codec from core, which keeps RFC 7230 tchar octets literal and percent-encodes the rest (including '%') with uppercase hexadecimal.
static Header	formatValue(List<String> protocolIds) Formats a list of raw ALPN protocol IDs into a single ALPN header.
static List<String>	parseValue(Header header) Parses an ALPN header into decoded protocol IDs.

Methods inherited from class java.lang.Object

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

Method Detail

formatValue

public static Header formatValue(List<String> protocolIds)

Formats a list of raw ALPN protocol IDs into a single ALPN header.

parseValue

public static List<String> parseValue(Header header)
                               throws ProtocolException

Parses an ALPN header into decoded protocol IDs.

Throws:

ProtocolException - if a token is not a well-formed percent-encoded protocol ID.

encodeId

public static String encodeId(String id)

Encodes a single raw protocol ID to canonical token form using the HTTP token codec from core, which keeps RFC 7230 tchar octets literal and percent-encodes the rest (including '%') with uppercase hexadecimal.

decodeId

public static String decodeId(String token)
                       throws ProtocolException

Decodes a percent-encoded token to a raw protocol ID using UTF-8.

A '%' that is not followed by two hexadecimal digits is a malformed token and is rejected as a protocol error.

Throws:

ProtocolException - if the token contains malformed percent-encoding.