Module http/index

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

The error that caused this one, or .None at the root of the chain.

Rust's Error::source. Defaulted to .None, so an error with nothing underneath it implements the trait by saying only what it is; a wrapper overrides it to hand back what it wrapped. Walking the chain to the root cause is not expressible yet — the returned Dyn loses the Error trait on an erased receiver, so a caller can print one link but cannot follow it (#521, issues/self-trait-in-a-return-type-loses-the-trait-on-an-erased-receiver.md).

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

Parse a request-line method token (case-sensitive, as RFC 9110 §9.1 requires). .None for anything not in the enum.

Create a response with the given status and reason phrase.

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Create a response with the given status and reason phrase.

Number of field LINES, counting each repeat of a name separately.

True when there are no field lines.

The first value for name, or .None. Case-insensitive.

Every value for name, in the order the field lines appeared. Empty when the field is absent — which is what makes Set-Cookie usable.

True when name has at least one value. Case-insensitive.

Add a value for name, KEEPING any existing values. Rust's HeaderMap::append.

Remove every value for name, returning how many field lines went.

Set name to exactly value, dropping every value it had. Rust's HeaderMap::insert. Returns the first previous value, if any — a caller overwriting a header usually wants to know it was there.

The field lines in order — for serialization and iteration. The list is a snapshot: pushing to it does not change the map.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Wrap a raw code, or .None when it is outside the 100-599 range RFC 9110 SS15 defines. An unrecognized code INSIDE the range is accepted — a client must treat an unknown 4xx as 400, so refusing it would break the very forward-compatibility the classes exist for.

The raw code.

1xx — the request was received and the process continues.

2xx — the request succeeded.

3xx — further action is needed to complete the request.

4xx — the request was malformed or cannot be fulfilled.

5xx — the server failed to fulfil an apparently valid request.

True if the status is 4xx or 5xx.

The reason phrase RFC 9110 registers for this code, or Unknown.

The phrase is ADVISORY: a server may send any text and a client must not act on it — which is why this is a lookup here rather than a field, and why HttpResponse keeps whatever phrase the peer actually sent.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Create a response with the given status and reason phrase.

Add a header and return the response (builder pattern). APPENDS, so a repeatable field can be built up by chaining.

Set the body and return the response (builder pattern).

Set the Host header, REPLACING any existing one — there is exactly one Host per request (RFC 9112 SS3.2), and appending a second used to put both on the wire.

Set a header, REPLACING every existing value for that name.

Set the request body.

Look up a header value by name (case-insensitive). The first value, when the field repeats — self.headers.get_all(name) for all of them, which is what Set-Cookie needs.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Create a response with the given status and reason phrase.

Look up a header value by name (case-insensitive). The first value, when the field repeats — self.headers.get_all(name) for all of them, which is what Set-Cookie needs.

Set a header, REPLACING every existing value for that name.

True if the status is 2xx.

True if the status is 3xx.

True if the status is 4xx or 5xx.

A response with status and its registered reason phrase.

Add a header and return the response (builder pattern). APPENDS, so a repeatable field can be built up by chaining.

Set the body and return the response (builder pattern).

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

Render self under spec. An unrecognised spec degrades to the plain to_string() rendering rather than failing.

Serialize to wire format, on the status line's own version (so a parsed response round-trips). A Content-Length header is added when none is present (the byte length of body), so the peer can delimit the message without waiting for close.

The error that caused this one, or .None at the root of the chain.

Rust's Error::source. Defaulted to .None, so an error with nothing underneath it implements the trait by saying only what it is; a wrapper overrides it to hand back what it wrapped. Walking the chain to the root cause is not expressible yet — the returned Dyn loses the Error trait on an erased receiver, so a caller can print one link but cannot follow it (#521, issues/self-trait-in-a-return-type-loses-the-trait-on-an-erased-receiver.md).

Create default options (GET, no headers, empty body, no timeout, 10 redirects, 64 MiB response ceiling).

Set the HTTP method.

Add a request header.

Set the request body.

Give the whole request (redirects included) a deadline.

Cap the number of redirect hops followed (0 = return 3xx verbatim).

Cap the raw response bytes buffered into memory (0 = unlimited).

Bind a listening socket on addr (port 0 picks a free port — read it back with local_addr()).

The address the server is listening on.

Set the request-size ceiling (builder pattern; 0 = unlimited).

Accept ONE connection, read one request, run handler, write the response and close. A request that does not parse gets a 400 Bad Request whose body names the defect, without calling handler; a framing defect (oversize, unreadable Content-Length, malformed chunking) is answered the same way (413 for oversize) instead of being thrown out of the server (issues/fixed/one-malformed-request-killed-http-server-serve.md).

Serve connections one after another until stop() has been called (checked after each connection completes).

Ask serve to return after the connection it is currently handling.

Close the listening socket.