Struct RequestBuilder

pub struct RequestBuilder<'a> { /* private fields */ }

An HTTP request builder

This is created through Client::get(), Client::post() etc. You need to call send() to actually send the request over the network. If you don’t want to send it and just want the resultant Request, you can call RequestBuilder::build.

Implementations

impl<'a> RequestBuilder<'a>

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

Set the request body.

pub fn headers(self, headers: HeaderMap) -> Self

Set the request headers.

pub fn header<H: Header>(self, header: H) -> Self

Set a single header using HeaderMapExt::typed_insert().

pub fn build(self) -> Result<Request<SharedBody>, Error>

Get the resultant Request.

Prefer RequestBuilder::send unless you have a specific need to get the resultant Request.

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

Send the request over the network.

Returns an error before sending the request if there is something wrong with the request parameters (method, uri, etc.).