software.amazon.awssdk.http

Interface SdkHttpHeaders

All Known Subinterfaces:

SdkHttpFullRequest, SdkHttpFullRequest.Builder, SdkHttpFullResponse, SdkHttpFullResponse.Builder, SdkHttpRequest, SdkHttpRequest.Builder, SdkHttpResponse, SdkHttpResponse.Builder

@Immutable
public interface SdkHttpHeaders

An immutable set of HTTP headers. SdkHttpRequest should be used for requests, and SdkHttpResponse should be used for responses.

Method Summary

Modifier and Type	Method and Description
default Optional<String>	firstMatchingHeader(Collection<String> headersToFind)
default Optional<String>	firstMatchingHeader(String header) Perform a case-insensitive search for a particular header in this request, returning the first matching header, if one is found.
default void	forEachHeader(BiConsumer<? super String,? super List<String>> consumer)
Map<String,List<String>>	headers() Returns a map of all HTTP headers in this message, sorted in case-insensitive order by their header name.
default List<String>	matchingHeaders(String header)
default int	numHeaders()

Method Detail

headers

Map<String,List<String>> headers()

Returns a map of all HTTP headers in this message, sorted in case-insensitive order by their header name.

This will never be null. If there are no headers an empty map is returned.

Returns:

An unmodifiable map of all headers in this message.

firstMatchingHeader

default Optional<String> firstMatchingHeader(String header)

Perform a case-insensitive search for a particular header in this request, returning the first matching header, if one is found.

This is useful for headers like 'Content-Type' or 'Content-Length' of which there is expected to be only one value present.

This is equivalent to invoking SdkHttpUtils.firstMatchingHeader(Map, String)

.

Parameters:

header - The header to search for (case insensitively).

Returns:

The first header that matched the requested one, or empty if one was not found.

firstMatchingHeader

default Optional<String> firstMatchingHeader(Collection<String> headersToFind)

matchingHeaders

default List<String> matchingHeaders(String header)

forEachHeader

default void forEachHeader(BiConsumer<? super String,? super List<String>> consumer)

numHeaders

default int numHeaders()