Struct Request 

pub struct Request<B = EmptyBody> {
    pub metadata: RequestMetadata,
    pub body: B,
}

A semantic request with an arbitrary body owner. The metadata is also accessible through dereferencing, e.g. request.fields and request.method.

Fields

metadata: RequestMetadata

body: B

Implementations

impl<B> Request<B>

pub fn new(method: Method, path: impl Into<Path>, body: B) -> Self

pub fn from_parts(metadata: RequestMetadata, body: B) -> Self

pub fn into_parts(self) -> (RequestMetadata, B)

pub fn map_body<T>(self, map: impl FnOnce(B) -> T) -> Request<T>

Move the body through map without cloning or rebuilding the metadata.

pub fn with_body<T>(self, body: T) -> Request<T>

Replace and drop the previous body. This does not drain it or establish asynchronous exchange cleanup; an I/O driver retains that responsibility.

pub fn is_head(&self) -> bool

pub fn is_connect(&self) -> bool

impl Request<EmptyBody>

pub fn get(path: impl Into<Path>) -> Self

impl<B: ReadableBody> Request<B>

pub async fn read( &mut self, cancellation: &Cancellation, ) -> Result<BodyFrame<B::Data>, B::Error>

Read an owned body frame. Received fields stay in the frame; the caller can forward them or explicitly append them with HttpHeaders::append_trailers.

Trait Implementations

impl<B: Clone> Clone for Request<B>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<B: Debug> Debug for Request<B>

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

Formats the value using the given formatter.

impl<B> Deref for Request<B>

type Target = RequestMetadata

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<B> DerefMut for Request<B>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.