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

An HTTP Request Type

Implementations§

source§

impl<B> Request<B>

source

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.

source

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

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

source

pub fn new(body: B) -> Self

Returns a GET request with no URI

source

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

Convert this request into its parts.

source

pub fn headers(&self) -> &Headers

Returns a reference to the header map

source

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

Returns a mutable reference to the header map

source

pub fn body(&self) -> &B

Returns the body associated with the request

source

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

Returns a mutable reference to the body

source

pub fn into_body(self) -> B

Converts this request into the request body.

source

pub fn method(&self) -> &str

Returns the method associated with this request

source

pub fn uri(&self) -> &str

Returns the URI associated with this request

source

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

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

source

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

Sets the URI of this request

source

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

Adds an extension to the request extensions

source§

impl Request<SdkBody>

source

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

Attempts to clone this request

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

source

pub fn take_body(&mut self) -> SdkBody

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

source

pub fn empty() -> Self

Create a GET request to / with an empty body

source

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

Creates a GET request to uri with an empty body

Trait Implementations§

source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

§

type Error = HttpError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

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

§

type Error = HttpError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.

Auto Trait Implementations§

§

impl<B = SdkBody> !RefUnwindSafe for Request<B>

§

impl<B> Send for Request<B>where B: Send,

§

impl<B> Sync for Request<B>where B: Sync,

§

impl<B> Unpin for Request<B>where B: Unpin,

§

impl<B = SdkBody> !UnwindSafe for Request<B>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unsharedwhere Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more