Type Members

1.  final class IllegalRequestContext extends AnyRef

   What is known about a request that failed to parse, at the point where parsing gave up.

   What is known about a request that failed to parse, at the point where parsing gave up.

   Every field is optional because a request can be rejected before that part of it has been read: a request with an unsupported method fails before the request target is seen, and one with an unparsable request target fails before the protocol is seen.

   Note that rawRequestTarget is unvalidated, attacker-controlled input, by definition malformed whenever the rejection was caused by the request target itself. It can carry any byte the client chose to send, including CR, LF, NUL and terminal control sequences, so anything that logs or echoes it has to escape it first: written raw into a log it lets a client forge log lines or drive the terminal that displays them, and written raw into a response body it is reflected input. toString escapes it and is safe to log as it is; the field itself is not.

   Since

   2.0.0

2.  abstract class ParsingErrorHandler extends AnyRef

   Produces the response to a request that failed to parse.

   Produces the response to a request that failed to parse. Selected by the pekko.http.server.parsing-error-handler setting.

   This is also the earliest public symbol that observes a rejected request, so it is what observability tooling attaches to: the OpenTelemetry Java agent instruments handle to emit a span for a request that never reaches the route handler (open-telemetry/opentelemetry-java-instrumentation#5139).