Struct Request 

#[non_exhaustive]
pub struct Request {
    pub method: Method,
    pub url: String,
    pub headers: Vec<(String, String)>,
    pub body: Option<Vec<u8>>,
}

A request that wafrift can transform.

Intentionally simple — no HTTP library dependency. The transport layer converts to/from reqwest::Request or raw bytes as needed.

Construction

Use the provided constructors (Request::get, Request::post, etc.) and builder methods (Request::header, Request::with_body). Direct struct construction is prevented by #[non_exhaustive].

Examples

Build a GET request, attach a header, then a JSON POST body:

use wafrift_types::request::{Method, Request};

let r = Request::get("https://example.com/api")
    .header("Accept", "application/json");
assert_eq!(r.method(), &Method::Get);
assert_eq!(r.url(), "https://example.com/api");
assert_eq!(r.headers().len(), 1);
assert_eq!(r.get_header("Accept"), Some("application/json"));
assert!(!r.has_body());

let r = Request::post("https://example.com/login", b"u=admin&p=admin".to_vec());
assert_eq!(r.method(), &Method::Post);
assert_eq!(r.body_bytes().unwrap(), b"u=admin&p=admin");

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

method: Method

HTTP method.

url: String

Full request URL.

headers: Vec<(String, String)>

Request headers as (name, value) pairs.

body: Option<Vec<u8>>

Optional request body.

Implementations

impl Request

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

Create a GET request.

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

Create a POST request with a body.

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

Create a PUT request with a body.

pub fn delete(url: impl Into<String>) -> Request

Create a DELETE request.

pub fn with_method(method: impl Into<Method>, url: impl Into<String>) -> Request

Create a request with an arbitrary method.

pub fn method(&self) -> &Method

Returns a reference to the HTTP method.

pub fn method_mut(&mut self) -> &mut Method

Returns a mutable reference to the HTTP method.

pub fn url(&self) -> &str

Returns the URL as a string slice.

pub fn url_mut(&mut self) -> &mut String

Returns a mutable reference to the URL.

pub fn headers(&self) -> &[(String, String)]

Returns a slice of the header pairs.

pub fn headers_mut(&mut self) -> &mut Vec<(String, String)>

Returns a mutable reference to the headers vec.

pub fn body_bytes(&self) -> Option<&[u8]>

Returns a reference to the body, if present.

pub fn set_body(&mut self, body: impl Into<Vec<u8>>)

Sets the body, replacing any existing body.

pub fn clear_body(&mut self)

Clears the body.

pub fn header( self, name: impl Into<String>, value: impl Into<String>, ) -> Request

Add a header to the request (builder pattern).

pub fn add_header(&mut self, name: impl Into<String>, value: impl Into<String>)

Add a header to the request (mutable reference version).

pub fn with_body(self, body: impl Into<Vec<u8>>) -> Request

Set the request body.

pub fn get_header(&self, name: &str) -> Option<&str>

Get the value of a header by name (case-insensitive).

pub fn get_headers(&self, name: &str) -> Vec<&str>

Get all values for a header name (case-insensitive).

pub fn content_type(&self) -> Option<&str>

Get the Content-Type header value.

pub fn has_body(&self) -> bool

Check if this request has a body.

pub fn body_str(&self) -> Option<&str>

Get the body as a UTF-8 string, if present and valid.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

fn deserialize<__D>( __deserializer: __D, ) -> Result<Request, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Request

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

Formats the value using the given formatter.

impl PartialEq for Request

fn eq(&self, other: &Request) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Request

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Request