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>

Available on crate feature http-02x only.

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>

Available on crate feature http-1x only.

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>

Available on crate feature http-02x only.

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>

Available on crate feature http-1x only.

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>

Available on crate feature http-02x only.

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>

Available on crate feature http-1x only.

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.