Struct Request

pub struct Request<B = SdkBody> { /* private fields */ }

An HTTP Request Type

Implementations

impl<B> Request<B>

pub fn try_into_http02x(self) -> Result<Request<B>, HttpError>

Converts this request into an http 0.x request.

Depending on the internal storage type, this operation may be free or it may have an internal cost.

pub fn try_into_http1x(self) -> Result<Request<B>, HttpError>

Converts this request into an http 1.x request.

Depending on the internal storage type, this operation may be free or it may have an internal cost.

pub fn map<U>(self, f: impl Fn(B) -> U) -> Request<U>

Update the body of this request to be a new body.

pub fn new(body: B) -> Self

Returns a GET request with no URI

pub fn into_parts(self) -> RequestParts<B>

Convert this request into its parts.

pub fn headers(&self) -> &Headers

Returns a reference to the header map

pub fn headers_mut(&mut self) -> &mut Headers

Returns a mutable reference to the header map

pub fn body(&self) -> &B

Returns the body associated with the request

pub fn body_mut(&mut self) -> &mut B

Returns a mutable reference to the body

pub fn into_body(self) -> B

Converts this request into the request body.

pub fn method(&self) -> &str

Returns the method associated with this request

pub fn uri(&self) -> &str

Returns the URI associated with this request

pub fn uri_mut(&mut self) -> &mut Uri

Returns a mutable reference the the URI of this http::Request

pub fn set_uri<U>(&mut self, uri: U) -> Result<(), U::Error>

where U: TryInto<Uri>,

Sets the URI of this request

pub fn add_extension<T: Send + Sync + Clone + 'static>(&mut self, extension: T)

Adds an extension to the request extensions

impl Request<SdkBody>

pub fn try_clone(&self) -> Option<Self>

Attempts to clone this request

On clone, any extensions will be cleared.

If the body is cloneable, this will clone the request. Otherwise None will be returned

pub fn take_body(&mut self) -> SdkBody

Replaces this request’s body with SdkBody::taken()

pub fn empty() -> Self

Create a GET request to / with an empty body

pub fn get(uri: impl AsRef<str>) -> Result<Self, HttpError>

Creates a GET request to uri with an empty body

Trait Implementations

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

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

Formats the value using the given formatter.

impl<B> TryFrom<Request<B>> for Request<B>

type Error = HttpError

The type returned in the event of a conversion error.

fn try_from(value: Request<B>) -> Result<Self, Self::Error>

Performs the conversion.

impl<B> TryFrom<Request<B>> for Request<B>

type Error = HttpError

The type returned in the event of a conversion error.

fn try_from(value: Request<B>) -> Result<Self, Self::Error>

Performs the conversion.

impl<B> TryInto<Request<B>> for Request<B>

type Error = HttpError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Request<B>, Self::Error>

Performs the conversion.

impl<B> TryInto<Request<B>> for Request<B>

type Error = HttpError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Request<B>, Self::Error>

Performs the conversion.