headerValue

Description

Traverses the list of request headers with the specified function and extracts the first value the function returns as Optional[value].

The headerValue directive is a mixture of map and find on the list of request headers. The specified function is called once for each header until the function returns Optional(value). This value is extracted and presented to the inner route. If the function throws an exception the request is rejected with a MalformedHeaderRejection. If the function returns Optional.empty for every header the request is rejected as "NotFound".

This directive is the basis for building other request header related directives.

See also headerValuePF for a nicer syntactic alternative.

Example

TODO: Example snippets for JavaDSL are subject to community contributions! Help us complete the docs, read more about it here: write example snippets for Akka HTTP Java DSL #20466.