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) -> Self

Creates a new builder.

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

Sets a header.

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

Sets multiple headers.

pub fn query(self, name: &str, value: &str) -> Self

Appends a query parameter to the URL.

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

Appends multiple query parameters to the URL.

pub fn body(self, body: B) -> Self

Sets the request body.

pub fn extension<T: Clone + Send + Sync + 'static>(self, value: T) -> Self

Insert a typed extension value.

Extensions allow middleware to attach arbitrary typed data to requests.

pub fn extensions(self, extensions: Extensions) -> Self

Set extensions from an existing Extensions container.

This replaces any previously set extensions.

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

Builds the Request.

impl RequestBuilder<Bytes>

pub fn json<T: Serialize>(self, value: &T) -> Result<Self>

Set a JSON body.

Errors

Returns an error if serialization fails.

pub fn form<T: Serialize>(self, value: &T) -> Result<Self>

Set a form-urlencoded body.

Errors

Returns an error if serialization fails.

Trait Implementations

impl<B: Clone> Clone for RequestBuilder<B>

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> Debug for RequestBuilder<B>

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

Formats the value using the given formatter.