pub struct RequestBuilder { /* private fields */ }Expand description
Fluent builder for constructing requests.
Implementations§
Source§impl RequestBuilder
impl RequestBuilder
Sourcepub fn body(self, body: impl Into<RequestBody>) -> Self
pub fn body(self, body: impl Into<RequestBody>) -> Self
Set the request body from any type that converts into RequestBody.
Sourcepub fn timeout(self, timeout: Timeout) -> Self
pub fn timeout(self, timeout: Timeout) -> Self
Set the timeout for this specific request.
When set, this overrides the client-level timeout on a per-field basis: only fields present here replace the corresponding client-level fields.
Sourcepub fn redirect_policy(self, policy: RedirectPolicy) -> Self
pub fn redirect_policy(self, policy: RedirectPolicy) -> Self
Override the redirect policy for this specific request.
When set, this overrides the client-level redirect policy for this request only.
Sourcepub fn auth(self, auth: impl Into<AuthScheme>) -> Self
pub fn auth(self, auth: impl Into<AuthScheme>) -> Self
Set authentication for this specific request.
Overrides client-level auth.
Sourcepub fn without_auth(self) -> Self
pub fn without_auth(self) -> Self
Disable authentication for this specific request.
When set, no auth is applied to this request even if the client has a default auth configured.
Sourcepub fn decompress(self, decompress: bool) -> Self
pub fn decompress(self, decompress: bool) -> Self
Override decompression for this specific request.
true: enable decompression regardless of client settingfalse: disable decompression regardless of client setting
Sourcepub fn max_decoded_body_size(self, max: usize) -> Self
pub fn max_decoded_body_size(self, max: usize) -> Self
Override the client decoded response body size limit for this request.
The request setting takes precedence over the client setting and is carried across retries and redirects. A value of zero rejects any non-empty decoded response body.
Sourcepub fn max_decompression_ratio(self, ratio: f64) -> Self
pub fn max_decompression_ratio(self, ratio: f64) -> Self
Override the client decompression ratio limit for this request.
The request setting takes precedence over the client setting and is carried across retries and redirects.
§Panics
Panics if ratio is not finite or not positive.
Sourcepub fn retry(self, policy: RetryPolicy) -> Self
pub fn retry(self, policy: RetryPolicy) -> Self
Override the retry policy for this specific request.
When set, this overrides the client-level retry policy for this request only.
Sourcepub fn without_retry(self) -> Self
pub fn without_retry(self) -> Self
Disable retries for this specific request, even if the client has a retry policy configured.
Sourcepub fn transport_hints(self, hints: TransportHints) -> Self
pub fn transport_hints(self, hints: TransportHints) -> Self
Set the transport hints for this request.
Transport hints control wire-level behavior (target override, SNI hostname) without affecting logical URL semantics.
Sourcepub fn resolved_addresses<I>(self, addresses: I) -> Selfwhere
I: IntoIterator<Item = SocketAddr>,
pub fn resolved_addresses<I>(self, addresses: I) -> Selfwhere
I: IntoIterator<Item = SocketAddr>,
Pin this request to caller-supplied remote destinations.
The logical URL remains unchanged for HTTP authority, TLS identity, redirects, cookies, and authentication. The set must be non-empty and each address must use the URL’s effective HTTP/HTTPS port. Static routing is direct-only; proxy and HTTP/3 combinations fail closed.