Trait WebRequest

pub trait WebRequest {
    type Error;
    type Response: WebResponse<Error = Self::Error>;

    // Required methods
    fn query(
        &mut self,
    ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>;
    fn urlbody(
        &mut self,
    ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>;
    fn authheader(&mut self) -> Result<Option<Cow<'_, str>>, Self::Error>;
}

Abstraction of web requests with several different abstractions and constructors needed by an endpoint. It is assumed to originate from an HTTP request, as defined in the scope of the rfc, but theoretically other requests are possible.

Required Associated Types

type Error

The error generated from access of malformed or invalid requests.

type Response: WebResponse<Error = Self::Error>

The corresponding type of Responses returned from this module.

Required Methods

fn query( &mut self, ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>

Retrieve a parsed version of the url query.

An Err return value indicates a malformed query or an otherwise malformed WebRequest. Note that an empty query should result in Ok(HashMap::new()) instead of an Err.

fn urlbody( &mut self, ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>

Retrieve the parsed application/x-form-urlencoded body of the request.

An Err value / indicates a malformed body or a different Content-Type.

fn authheader(&mut self) -> Result<Option<Cow<'_, str>>, Self::Error>

Contents of the authorization header or none if none exists. An Err value indicates a malformed header or request.

Implementations on Foreign Types

impl<'a, W: WebRequest> WebRequest for &'a mut W

type Error = <W as WebRequest>::Error

type Response = <W as WebRequest>::Response

fn query( &mut self, ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>

fn urlbody( &mut self, ) -> Result<Cow<'_, dyn QueryParameter + 'static>, Self::Error>

fn authheader(&mut self) -> Result<Option<Cow<'_, str>>, Self::Error>

Implementors

impl WebRequest for Request

type Error = NoError

type Response = Response

impl<W: WebRequest, F, T> WebRequest for MapErr<W, F, T>

where F: FnMut(W::Error) -> T,

type Error = T

type Response = MapErr<<W as WebRequest>::Response, F, T>