Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

Fluent builder for HttpRequest.

Single-purpose, chainable. Each method returns &mut Self for fluent chaining; call RequestBuilder::build to obtain the final HttpRequest.

Examples

use http_request::{RequestBuilder, Proxy};

// sync GET
let mut req = RequestBuilder::new()
    .get("https://example.com/api")
    .header("Accept", "application/json")
    .timeout(5_000)
    .build();
let _resp = req.send();

// async POST with JSON body
let req = RequestBuilder::new()
    .post("https://example.com/api")
    .body_json(&serde_json::json!({"k": "v"}))
    .header("Content-Type", "application/json")
    .proxy(Proxy::https("127.0.0.1", 7890).auth("u", "p"))
    .build();
let _resp = req.send_async().await;

Implementations

impl RequestBuilder

pub fn new() -> Self

Create an empty builder (defaults: GET, no headers, default config).

pub fn get(&mut self, url: impl Into<String>) -> &mut Self

Shortcut for method(Method::Get) + url(url).

pub fn post(&mut self, url: impl Into<String>) -> &mut Self

Shortcut for method(Method::Post) + url(url).

pub fn method(&mut self, method: Method) -> &mut Self

Set HTTP method explicitly (Method::Get / Method::Post / etc.).

pub fn url(&mut self, url: impl Into<String>) -> &mut Self

Set URL.

pub fn header<K: AsRef<str>, V: AsRef<str>>( &mut self, key: K, value: V, ) -> &mut Self

Set a single header (last write wins on duplicate keys).

pub fn headers<K, V>(&mut self, headers: HashMap<K, V>) -> &mut Self

where K: AsRef<str>, V: AsRef<str>,

Set many headers at once.

pub fn remove_header<K: AsRef<str>>(&mut self, key: K) -> &mut Self

Remove a header by key.

pub fn clear_headers(&mut self) -> &mut Self

Clear all headers.

pub fn body<B: Into<Vec<u8>>>(&mut self, bytes: B) -> &mut Self

Set raw body bytes.

pub fn body_text<T: Into<String>>(&mut self, text: T) -> &mut Self

Set UTF-8 text body (will be encoded per Content-Type on send).

pub fn body_json<V: Serialize>(&mut self, value: &V) -> &mut Self

Set JSON body (serialised via serde_json).

pub fn timeout(&mut self, ms: u64) -> &mut Self

Set request timeout in milliseconds.

pub fn buffer_size(&mut self, n: usize) -> &mut Self

Set per-read buffer size.

pub fn http1_1_only(&mut self) -> &mut Self

Force HTTP/1.1.

pub fn http2_only(&mut self) -> &mut Self

Force HTTP/2.

pub fn redirect(&mut self) -> &mut Self

Enable auto-follow of 3xx redirects.

pub fn no_redirect(&mut self) -> &mut Self

Disable auto-follow of 3xx redirects (default).

pub fn max_redirect_times(&mut self, n: usize) -> &mut Self

Maximum number of redirects to follow (default DEFAULT_MAX_REDIRECT_TIMES).

pub fn decode(&mut self) -> &mut Self

Enable automatic response body decompression (gzip / deflate / br).

pub fn no_decode(&mut self) -> &mut Self

Disable automatic response body decompression.

pub fn proxy(&mut self, proxy: Proxy) -> &mut Self

Set the proxy configuration. Pass None (via [Proxy::default()) to clear an existing proxy.

Construct via Proxy::http / Proxy::https / Proxy::socks5 and optionally chain .auth(user, pass).

pub fn no_proxy(&mut self) -> &mut Self

Clear the proxy (use direct connection).

pub fn build(&mut self) -> HttpRequest

Finalise the builder and return the HttpRequest.

Trait Implementations

impl Clone for RequestBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestBuilder

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

Formats the value using the given formatter.

impl Default for RequestBuilder

fn default() -> Self

Returns the “default value” for a type.