Struct Body

Source

pub struct Body(/* private fields */);

Expand description

Handle for accessing and mutating an HTTP body stream.

A Body is tied to a specific request or response context, depending on how it is constructed. Use it to read the full buffered body or write a new one.

Implementations§

Source §

impl Body

Source

pub fn read(&self) -> Bytes

Read the entire body into memory and return it as Bytes.

This returns the buffered payload when body buffering is enabled by the host.

feature::BufferRequest is required to read without consuming the request body. To enable it, call admin::enable(BufferRequest) before returning from handle_request. Otherwise, the next handler may panic attempting to read the request body because it was already read.

feature::BufferResponse is required to read the response body produced by the next handler defined on the host inside handle_response. To enable it, call admin::enable(BufferResponse) beforehand. Otherwise, the guest may read EOF because the downstream handler already consumed it.

Examples found in repository ?

examples/info.rs (line 23)

17    fn handle_request(&self, request: &Request, _response: &Response) -> (bool, i32) {
18        info!("Request: {} {} {} {}", request.method(), request.version(), request.uri(), request.source_addr());
19        for (name, values) in request.header.entries_iter() {
20            let values = values.iter().map(|v| format!("{v}")).collect::<Vec<_>>().join(", ");
21            info!("Header: {} [{}]", name, values);
22        }
23        info!("Body: {}", request.body.read());
24        (true, 0)
25    }