Struct RequestBuilder 

pub struct RequestBuilder<B = Bytes> { /* private fields */ }

Builder for constructing Request instances.

Implementations

impl<B> RequestBuilder<B>

pub fn new(method: Method, url: Url) -> RequestBuilder<B>

Creates a new builder.

pub fn header( self, name: impl Into<String>, value: impl Into<String>, ) -> RequestBuilder<B>

Sets a header.

pub fn headers( self, headers: impl IntoIterator<Item = (String, String)>, ) -> RequestBuilder<B>

Sets multiple headers.

pub fn query(self, name: &str, value: &str) -> RequestBuilder<B>

Appends a query parameter to the URL.

pub fn query_pairs( self, pairs: impl IntoIterator<Item = (String, String)>, ) -> RequestBuilder<B>

Appends multiple query parameters to the URL.

pub fn body(self, body: B) -> RequestBuilder<B>

Sets the request body.

pub fn extension<T>(self, value: T) -> RequestBuilder<B>

where T: Clone + Send + Sync + 'static,

Insert a typed extension value.

Extensions allow middleware to attach arbitrary typed data to requests.

pub fn extensions(self, extensions: Extensions) -> RequestBuilder<B>

Set extensions from an existing Extensions container.

This replaces any previously set extensions.

pub fn build(self) -> Request<B>

Builds the Request.

impl RequestBuilder

pub fn json<T>(self, value: &T) -> Result<RequestBuilder, Error>

where T: Serialize,

Set a JSON body.

Errors

Returns an error if serialization fails.

pub fn form<T>(self, value: &T) -> Result<RequestBuilder, Error>

where T: Serialize,

Set a form-urlencoded body.

Errors

Returns an error if serialization fails.

Trait Implementations

impl<B> Clone for RequestBuilder<B>

where B: Clone,

fn clone(&self) -> RequestBuilder<B>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B> Debug for RequestBuilder<B>

where B: Debug,

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

Formats the value using the given formatter.