Struct IncomingRequest

pub struct IncomingRequest { /* private fields */ }

Represents an incoming HTTP Request.

Implementations

impl IncomingRequest

pub fn method(&self) -> Method

Returns the method of the incoming request.

impl IncomingRequest

pub fn path_with_query(&self) -> Option<String>

Returns the path with query parameters from the request, as a string.

impl IncomingRequest

pub fn scheme(&self) -> Option<Scheme>

Returns the protocol scheme from the request.

impl IncomingRequest

pub fn authority(&self) -> Option<String>

Returns the authority of the Request’s target URI, if present.

impl IncomingRequest

pub fn headers(&self) -> Fields

Get the headers associated with the request.

The returned headers resource is immutable: set, append, and delete operations will fail with header-error.immutable.

The headers returned are a child resource: it must be dropped before the parent incoming-request is dropped. Dropping this incoming-request before all children are dropped will trap.

impl IncomingRequest

pub fn consume(&self) -> Result<IncomingBody, ()>

Gives the incoming-body associated with this request. Will only return success at most once, and subsequent calls will return error.

Trait Implementations

impl Debug for IncomingRequest

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

Formats the value using the given formatter.

impl TryFrom<IncomingRequest> for IncomingBody

type Error = Error

The type returned in the event of a conversion error.

fn try_from(request: IncomingRequest) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<IncomingRequest> for Request<IncomingBody>

type Error = Error

fn try_from(request: IncomingRequest) -> Result<Self, Self::Error>