Struct HttpRequest 

pub struct HttpRequest {
    pub id: RequestId,
    pub method: Method,
    pub url: String,
    pub headers: HashMap<String, String>,
    pub body: Option<Vec<u8>>,
    pub timeout: Duration,
    pub max_retries: u32,
    pub priority: i32,
    pub tag: Option<String>,
    pub cache_policy: CachePolicy,
}

An HTTP request to be issued by the client.

Fields

id: RequestId

Unique id, used to match events to requests.

method: Method

HTTP method.

url: String

Full URL including scheme, for example https://example.com/scores.

headers: HashMap<String, String>

Request headers.

body: Option<Vec<u8>>

Request body, if any.

timeout: Duration

Time allowed for each attempt (default 10 s).

max_retries: u32

Retries after a connection error, timeout or 5xx response (default 3).

priority: i32

Priority: higher = processed first. Default 0.

tag: Option<String>

Tag for grouping/cancellation.

cache_policy: CachePolicy

Cache behavior.

Implementations

impl HttpRequest

pub fn get(url: impl Into<String>) -> Self

A GET request.

pub fn post(url: impl Into<String>, body: Vec<u8>) -> Self

A POST request with a raw body.

pub fn post_json(url: impl Into<String>, json: impl Into<String>) -> Self

A POST request with a JSON body and Content-Type: application/json.

pub fn new(method: Method, url: impl Into<String>) -> Self

A request with a fresh id, 10 s timeout, 3 retries and UseCache.

pub fn with_header(self, key: impl Into<String>, val: impl Into<String>) -> Self

Add or replace a header.

pub fn with_timeout(self, t: Duration) -> Self

Set the per-attempt timeout.

pub fn with_retries(self, n: u32) -> Self

Set the number of retries.

pub fn with_priority(self, p: i32) -> Self

Set the priority; higher is sent first.

pub fn with_tag(self, t: impl Into<String>) -> Self

Set a tag that HttpClient::cancel_by_tag can match.

pub fn with_cache(self, p: CachePolicy) -> Self

Set the cache policy.

pub fn bearer_auth(self, token: impl Into<String>) -> Self

Add Authorization: Bearer <token>.

Trait Implementations

impl Clone for HttpRequest

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 HttpRequest

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

Formats the value using the given formatter.