Struct Request 

pub struct Request { /* private fields */ }

Represents an incoming HTTP request.

Provides high-level access to request data without exposing unsafe code. Data is lazily loaded from the host on first access.

Implementations

impl Request

pub fn method(&mut self) -> Method

Returns the HTTP method as an enum.

pub fn method_str(&mut self) -> String

Returns the HTTP method as a string.

pub fn path(&mut self) -> &str

Returns the request path (e.g., “/api/users/123”).

pub fn path_segments(&mut self) -> &[String]

Returns the path split into segments. Example: “/api/users/123” -> [“api”, “users”, “123”]

pub fn path_segment(&mut self, index: usize) -> Option<&str>

Returns a specific path segment by index. Example: for “/api/users/123”, segment(1) returns Some(“users”)

pub fn query(&mut self) -> &HashMap<String, String>

Returns all query parameters as a map. If a key appears multiple times, only the last value is kept.

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

Returns all query parameters as a list of key-value pairs. Preserves duplicate keys.

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

Gets a query parameter by name.

pub fn headers(&mut self) -> &HashMap<String, String>

Returns all headers as a map. Header names are lowercase.

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

Returns all headers as a list of key-value pairs.

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

Gets a header by name (case-insensitive).

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

Returns the Content-Type header value.

pub fn cookies(&mut self) -> &HashMap<String, String>

Returns all cookies as a map.

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

Gets a cookie by name.

pub fn body(&mut self) -> &[u8]

Returns the request body as bytes.

pub fn body_string(&mut self) -> Result<String, FromUtf8Error>

Returns the request body as a string. Returns an error if the body is not valid UTF-8.

pub fn body_json<T: DeserializeOwned>(&mut self) -> Result<T, Error>

Parses the request body as JSON.

Trait Implementations

impl Default for Request

fn default() -> Self

Returns the “default value” for a type.