Struct Request 

pub struct Request<'r> { /* private fields */ }

The request as gates and handlers read it: the parts web-net has checked (the host matched a site, the path is canonical) and the raw request underneath.

Implementations

impl<'r> Request<'r>

pub fn method(&self) -> Method

The method.

pub fn path(&self) -> &'r str

The canonical path inside the site: the base path removed, percent escapes in their one canonical form. / for the site root.

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

The query after ?, as received (validated by the parser, not decoded).

pub fn host(&self) -> &'r str

The host the request named, as received (empty for an HTTP/1.0 request without one). It matched one of the site’s hosts, unless the site accepts any host.

pub fn header(&self, name: &str) -> Option<&'r [u8]>

The first value of a field.

pub fn header_str(&self, name: &str) -> Option<&'r str>

The first value of a field, if it is UTF-8.

pub fn cookie(&self, name: &str) -> Result<Option<&'r str>, Ambiguous>

The value of the cookie name, read with cookie-net. Ok(None) when there is no such cookie.

Errors

Ambiguous when the name appears twice, or the request has more than one Cookie field: a sign of cookie tossing, never resolved by picking one.

pub fn client(&self) -> &'r ClientInfo

The client, as serve-net established it (the real address behind a trusted proxy).

pub fn scheme(&self) -> Scheme

https when the request came over TLS (or from a trusted proxy that said so).

pub fn route(&self) -> Option<&'r str>

The pattern of the matched route (/users/:id), once routing ran.

pub fn id(&self) -> RequestId

The request’s reference.

pub fn envelope(&self) -> &'r Envelope

serve-net’s facts about the request.

pub fn raw(&self) -> &'r HttpRequest<'r>

The raw request: the target as received, every field, the body.

Trait Implementations

impl<'r> Clone for Request<'r>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'r> Copy for Request<'r>

impl Debug for Request<'_>

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

Formats the value using the given formatter.