Struct Request 

pub struct Request { /* private fields */ }

A fully-received HTTP request: the request line, headers, and a fully buffered body.

The engine buffers the entire body before yielding a Request, so handlers see a complete message. Streaming request bodies are out of scope for this version.

Implementations

impl Request

pub fn method(&self) -> &Method

The request method.

pub fn target(&self) -> &str

The raw request target (origin-form path, possibly with a query string), exactly as sent on the request line.

pub fn path(&self) -> &str

The path portion of the target, i.e. everything before the first ?.

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

The query string (without the leading ?), if present.

pub fn version(&self) -> Version

The HTTP version.

pub fn headers(&self) -> &Headers

The request headers.

pub fn host(&self) -> Option<&str>

The value of the Host header, if any.

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

The buffered request body.

pub fn body_str(&self) -> Cow<'_, str>

The request body interpreted as UTF-8 (lossily).

pub fn into_body(self) -> Vec<u8>

Consume the request and return the owned body bytes.

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

The value of a path parameter captured by the Router, e.g. req.param("id") for a route registered as /users/:id. Returns None if the request was not routed or has no such parameter.

pub fn params(&self) -> impl Iterator<Item = (&str, &str)>

All captured path parameters, in match order.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl From<Request<Vec<u8>>> for Request

fn from(req: Request<Vec<u8>>) -> Self

Converts to this type from the input type.

impl TryFrom<&Request> for Request<Vec<u8>>

type Error = HttpConvertError

The type returned in the event of a conversion error.

fn try_from(req: &Request) -> Result<Self, Self::Error>

Performs the conversion.