Struct PreparedRequest 

pub struct PreparedRequest {
    pub method: HttpMethod,
    pub url: Url,
    pub headers: HashMap<String, String>,
    pub body: Option<String>,
}

A fully-assembled HTTP request: method, URL, headers, optional body.

Independent of any HTTP client. Callers translate the fields into their transport’s request builder (reqwest::Request, ureq::Request, …) before dispatching.

Fields

method: HttpMethod

HTTP verb.

url: Url

Fully-qualified endpoint URL (with any query string already appended).

headers: HashMap<String, String>

Extra headers to attach to the request. Content-Type is set automatically by PreparedRequest::with_json_body and PreparedRequest::with_raw_body.

body: Option<String>

Request body, if any. None for GET / header-only requests.

Implementations

impl PreparedRequest

pub fn new(method: HttpMethod, url: Url) -> Self

Build an empty request with the given method and URL.

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

Insert or overwrite a header. Chainable.

pub fn with_json_body<T: Serialize>(self, data: &T) -> Result<Self>

Serialise data as JSON, attach as body, and set Content-Type: application/json. Fails only if serialisation itself fails.

pub fn with_raw_body(self, body: String, content_type: &str) -> Self

Attach a raw string body with a caller-provided Content-Type.

Trait Implementations

impl Clone for PreparedRequest

fn clone(&self) -> PreparedRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreparedRequest

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

Formats the value using the given formatter.