Struct Request 

pub struct Request { /* private fields */ }

HTTP Request wrapper

Provides access to all parts of an incoming HTTP request.

Implementations

impl Request

pub fn method(&self) -> &Method

Get the HTTP method

pub fn uri(&self) -> &Uri

Get the URI

pub fn version(&self) -> Version

Get the HTTP version

pub fn headers(&self) -> &HeaderMap

Get the headers

pub fn extensions(&self) -> &Extensions

Get request extensions

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

Get mutable extensions

pub fn path(&self) -> &str

Get the request path

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

Get the query string

pub fn take_body(&mut self) -> Option<Bytes>

Take the body bytes (can only be called once)

Returns None if the body is streaming or already consumed. Use load_body().await first if you need to ensure the body is available as bytes.

pub fn take_stream(&mut self) -> Option<Incoming>

Take the body as a stream (can only be called once)

pub async fn load_body(&mut self) -> Result<(), ApiError>

Ensure the body is loaded into memory.

If the body is streaming, this collects it into Bytes. If already buffered, does nothing. Returns error if collection fails.

pub fn path_params(&self) -> &PathParams

Get path parameters

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

Get a specific path parameter

pub fn state(&self) -> &Arc<Extensions>

Get shared state

pub fn try_clone(&self) -> Option<Request>

Try to clone the request.

This creates a deep copy of the request, including headers, body (if present), path params, and shared state.

Returns None if the body is streaming (cannot be cloned) or already consumed.

Trait Implementations

impl Debug for Request

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

Formats the value using the given formatter.