Struct Request

pub struct Request {
    pub method: HttpMethod,
    pub url: Url,
    pub headers: Headers,
    pub body: Option<Vec<u8>>,
}

HTTP request.

Fields

method: HttpMethod

HTTP method (GET, POST, etc.).

url: Url

Target URL.

headers: Headers

Request headers.

body: Option<Vec<u8>>

Optional request body.

Implementations

impl Request

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

Create a new request with the given method and URL.

pub fn get(url: Url) -> Self

Create a GET request.

pub fn head(url: Url) -> Self

Create a HEAD request (for checking file size, etc.).

pub fn post(url: Url) -> Self

Create a POST request.

pub fn put(url: Url) -> Self

Create a PUT request.

pub fn delete(url: Url) -> Self

Create a DELETE request.

pub fn with_body(self, body: Vec<u8>) -> Self

Set the request body.

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

Set a header.

pub fn with_content_type(self, content_type: impl Into<String>) -> Self

Set Content-Type header.

pub fn method_str(&self) -> &'static str

Get the request method as string.

pub fn to_wire_format(&self) -> Vec<u8>

Serialize the request to HTTP/1.1 wire format.

Format:

METHOD /path HTTP/1.1\r\n
Header: Value\r\n
...
\r\n
[body]

pub fn wire_size(&self) -> usize

Get the total size of the serialized request.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy 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

Formats the value using the given formatter.