Skip to main content

RequestBuilder

rama::http::service::client

Struct RequestBuilder 

pub struct RequestBuilder<S> { /* private fields */ }
Expand description

A builder to construct the properties of a Request.

Constructed using HttpClientExt.

Implementations§

§

impl<S> RequestBuilder<S>

pub fn header<K, V>(self, key: K, value: V) -> RequestBuilder<S>
where K: IntoHeaderName, V: IntoHeaderValue,

Add a Header to this Request.

pub fn typed_header<H>(self, header: H) -> RequestBuilder<S>
where H: HeaderEncode,

Add a typed HeaderEncode to this Request.

pub fn headers(self, headers: HeaderMap) -> RequestBuilder<S>

Add all Headers from the HeaderMap to this Request.

pub fn overwrite_header<K, V>(self, key: K, value: V) -> RequestBuilder<S>
where K: IntoHeaderName, V: IntoHeaderValue,

Overwrite a Header to this Request.

pub fn overwrite_typed_header<H>(self, header: H) -> RequestBuilder<S>
where H: HeaderEncode,

Overwrite a typed HeaderEncode to this Request.

pub fn auth(self, credentials: impl Credentials) -> RequestBuilder<S>

Enable HTTP authentication.

pub fn extension<T>(self, extension: T) -> RequestBuilder<S>
where T: Extension + Clone,

Adds an extension to this builder

pub fn extensions_mut(&mut self) -> Option<&mut Extensions>

Get mutable access to the underlying Extensions

This function will return None if Extensions are not available, or if this builder is in an error state

pub fn body<T>(self, body: T) -> RequestBuilder<S>
where T: TryInto<Body>, <T as TryInto<Body>>::Error: Into<Box<dyn Error + Send + Sync>>,

Set the Request’s Body.

pub fn form<T>(self, form: &T) -> RequestBuilder<S>
where T: Serialize + ?Sized,

Set the given value as a URL-Encoded Form Body in the Request.

pub fn json<T>(self, json: &T) -> RequestBuilder<S>
where T: Serialize + ?Sized,

Set the given value as a JSON Body in the Request.

pub fn version(self, version: Version) -> RequestBuilder<S>

Set the http Version of this Request.

§

impl<S> RequestBuilder<S>

pub fn try_into_request(self) -> Result<Request, Box<dyn Error + Send + Sync>>

Constructs the Request.

§Errors

This method fails if there was an error while building the Request.

§

impl<S, Body> RequestBuilder<RQOwnedService<S>>
where S: Service<Request, Output = Response<Body>>, <S as Service<Request>>::Error: Into<Box<dyn Error + Send + Sync>>,

pub fn into_service(self) -> S

Cancels the Request building and returns the inner Service.

pub fn try_into_parts( self, ) -> Result<(Request, S), Box<dyn Error + Send + Sync>>

Constructs the Request and return it together with the inner Service.

§Errors

This method fails if there was an error while building the Request.

§

impl<S> RequestBuilder<S>
where S: RequestServiceHandle,

pub async fn send( self, ) -> Result<Response<<S as RequestServiceHandle>::Body>, Box<dyn Error + Send + Sync>>

Constructs the Request and sends it to the target Uri, returning the Service’s result.

§Errors

This method fails if there was an error while building the Request or processing it using the inner Service.

Trait Implementations§

§

impl<S> Debug for RequestBuilder<S>
where S: Debug,

§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<S> !Freeze for RequestBuilder<S>

§

impl<S> !RefUnwindSafe for RequestBuilder<S>

§

impl<S> Send for RequestBuilder<S>
where S: Send,

§

impl<S> Sync for RequestBuilder<S>
where S: Sync,

§

impl<S> Unpin for RequestBuilder<S>
where S: Unpin,

§

impl<S> UnsafeUnpin for RequestBuilder<S>
where S: UnsafeUnpin,

§

impl<S> !UnwindSafe for RequestBuilder<S>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where 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.

§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self> ⓘ

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

impl<T> Instrument for T

§

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

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

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 T
where 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<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> IntoRequest<T> for T

§

fn into_request(self) -> Request<T>

Wrap the input message T in a rama_grpc::Request
§

impl<L> LayerExt<L> for L

§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
§

impl<T, U> RamaFrom<T> for U
where U: From<T>,

§

fn rama_from(value: T) -> U

§

impl<T, U, CrateMarker> RamaInto<U, CrateMarker> for T
where U: RamaFrom<T, CrateMarker>,

§

fn rama_into(self) -> U

§

impl<T, U> RamaTryFrom<T> for U
where U: TryFrom<T>,

§

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

§

fn rama_try_from(value: T) -> Result<U, <U as RamaTryFrom<T>>::Error>

§

impl<T, U, CrateMarker> RamaTryInto<U, CrateMarker> for T
where U: RamaTryFrom<T, CrateMarker>,

§

type Error = <U as RamaTryFrom<T, CrateMarker>>::Error

§

fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T, CrateMarker>>::Error>

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

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 T
where U: TryFrom<T>,

Source§

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.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

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
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

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

impl<T> Extension for T
where T: Any + Send + Sync + Debug + 'static,