Struct Request 

pub struct Request { /* private fields */ }

Handler-facing HTTP request. Owns all data.

Implementations

impl Request

pub fn method(&self) -> &'static str

Return the uppercase HTTP method string.

pub fn is_head(&self) -> bool

True when the original request method is HEAD.

Handlers can check this to skip expensive body construction. The runtime strips the body automatically for HEAD responses, but this method lets handlers avoid building it in the first place.

pub fn path(&self) -> &str

Return the request path without the query string.

pub fn headers(&self) -> impl Iterator<Item = (&str, &str)> + '_

Iterate over all request headers as (name, value) pairs.

Invalid header values are yielded as empty strings.

pub fn header(&self, name: &str) -> Option<&str>

Return the first header value matching the given name (case-insensitive).

Uses hyper’s O(1) hash lookup — no linear scan.

pub fn remote_addr(&self) -> Option<IpAddr>

Return the remote IP address of the connecting client, if available.

pub fn body(&self) -> &str

Return the request body as text.

Invalid UTF-8 is decoded lossily on first access and cached.

pub fn body_bytes(&self) -> &[u8]

Return the raw body bytes.

pub fn json<T: DeserializeOwned>(&self) -> Result<T, RuntimeError>

Deserialize the request body as JSON.

pub fn multipart(&self) -> Result<MultipartReader, RuntimeError>

Parse the request body as multipart/form-data.

Returns a MultipartReader that provides access to all parts. Fails with BadRequest if the Content-Type is not multipart/form-data.

pub fn query(&self, name: &str) -> Option<&str>

Return the first query parameter value for the given key, or None.

pub fn query_all<'a>( &'a self, name: &'a str, ) -> impl Iterator<Item = &'a str> + 'a

Return an iterator over all query parameter values for the given key.

pub fn form(&self, name: &str) -> Option<&str>

Return the first form field value for the given key, or None.

Lazily parses the request body as application/x-www-form-urlencoded.

pub fn cookie(&self, name: &str) -> Option<&str>

Return the value of a cookie by name, or None if not present.

Lazily parses the Cookie header on first access.

pub fn cookies(&self) -> impl Iterator<Item = (&str, &str)> + '_

Iterate over all cookie name-value pairs.

Lazily parses the Cookie header on first access.

pub fn param(&self, name: &str) -> Option<&str>

Look up a path parameter by name.

pub fn builder() -> RequestBuilder

Create a RequestBuilder for constructing test requests.

Trait Implementations

impl Debug for Request

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.