Struct Request

pub struct Request<T> { /* private fields */ }

Represents an HTTP request.

This struct holds the HTTP method, version, URL, headers, and body of the request. The body is generic, allowing flexibility in request content.

Implementations

impl<T> Request<T>

pub fn new(method: Method, uri: Uri, body: T) -> Self

Creates a new Request with the specified method, version, URL, and body.

Parameters

• method: The HTTP method of the request (e.g., GET, POST).
• uri: The URL of the request.
• body: The content of the request body.

Returns

A new Request instance with empty headers.

pub fn from_parts(parts: Parts, body: T) -> Self

Creates a request from the given parts and body.

pub fn method(&self) -> &Method

Returns a reference to the HTTP method of the request.

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

Returns a mutable reference to the HTTP method of the request.

pub fn version(&self) -> &Version

Returns a reference to the HTTP version of the request.

pub fn version_mut(&mut self) -> &mut Version

Returns a mutable reference to the HTTP version of the request.

pub fn uri(&self) -> &Uri

Returns a reference to the URL of the request.

pub fn uri_mut(&mut self) -> &mut Uri

Returns a mutable reference to the URL of the request.

pub fn headers(&self) -> &Headers

Returns a reference to the headers of the request.

pub fn headers_mut(&mut self) -> &mut Headers

Returns a mutable reference to the headers of the request.

pub fn extensions(&self) -> &Extensions

Returns this request extensions.

pub fn extensions_mut(&mut self) -> &mut Extensions

Returns a mutable reference to the request extensions.

pub fn body(&self) -> &T

Returns a reference to the body of the request.

pub fn body_mut(&mut self) -> &mut T

Returns a mutable reference to the body of the request.

pub fn parts(&self) -> &Parts

Returns a reference to the request parts.

pub fn parts_mut(&mut self) -> &mut Parts

Returns a mutable reference to the request parts.

pub fn into_body(self) -> T

Returns the body

pub fn into_parts(self) -> (T, Parts)

Split this request into its body and rest of the parts.

pub fn drop_body(self) -> (Request<()>, T)

Separates the request and the body.

pub fn map_body<F, U>(self, f: F) -> Request<U>

where F: FnOnce(T) -> U,

Maps this request body to other type.

impl Request<()>

pub fn with_body<T>(req: Request<()>, body: T) -> Request<T>

Creates a new request from other with no body.

pub fn builder() -> Builder

Returns a Builder for constructing a new Request.

Example

use http1::{method::Method,request::Request};

let request = Request::builder()
    .method(Method::POST)
    .uri("/submit")
    .body("body content")
    .unwrap();

Trait Implementations

impl<T: Debug> Debug for Request<T>

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

Formats the value using the given formatter.