Struct conjure_runtime::RequestBuilder

pub struct RequestBuilder<'a, T = DefaultRawClient> { /* fields omitted */ }

A builder for an asynchronous HTTP request.

Implementations

impl<'a, T> RequestBuilder<'a, T>

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

Returns a mutable reference to the headers of this request.

The following headers are set by default, but can be overridden:

• Accept-Encoding: gzip, deflate
• Accept: */*
• User-Agent: <provided at Client construction>

The following headers are fully controlled by conjure_runtime, which will overwrite any existing value.

• Connection
• Content-Length
• Content-Type
• Host
• Proxy-Authorization
• X-B3-Flags
• X-B3-ParentSpanId
• X-B3-Sampled
• X-B3-SpanId
• X-B3-TraceId

pub fn bearer_token(self, token: &BearerToken) -> Self

Sets the Authorization request header to a bearer token.

This is a simple convenience wrapper.

pub fn param<U>(self, name: &str, value: U) -> Self where
    U: ToString, 

Adds a parameter.

Parameters which match names in the path pattern will be treated as path parameters, and other parameters will be treated as query parameters. Only one instance of path parameters may be provided, but multiple instances of query parameters may be provided.

pub fn idempotent(self, idempotent: bool) -> Self

Sets the idempotency of the request.

Idempotent requests can be retried if an IO error is encountered.

The default value is controlled by the Idempotency enum.

pub fn body<U>(self, body: U) -> Self where
    U: Body + Sync + Send + 'a, 

Sets the request body.

impl<'a, T, B> RequestBuilder<'a, T> where
    T: Service<Request<RawBody>, Response = Response<B>> + 'static + Sync + Send,
    T::Error: Into<Box<dyn Error + Sync + Send>>,
    T::Future: Send,
    B: Body<Data = Bytes> + 'static + Sync + Send,
    B::Error: Into<Box<dyn Error + Sync + Send>>, 

pub async fn send(self) -> Result<Response<B>, Error>

Makes the request.