Struct Request 

pub struct Request {
    pub method: Method,
    pub uri: Uri,
    pub headers: HeaderMap,
    pub body: Bytes,
    pub params: Params,
    pub query: Query,
    pub extensions: Extensions,
    pub remote_addr: Option<SocketAddr>,
    /* private fields */
}

HTTP Request wrapper

Fields

method: Method

uri: Uri

headers: HeaderMap

body: Bytes

params: Params

query: Query

extensions: Extensions

Typed per-request data; middleware can attach values for handlers (authenticated user, request id, …).

remote_addr: Option<SocketAddr>

Address of the connected peer (the proxy when behind one)

Implementations

impl Request

pub fn new(method: Method, uri: Uri, headers: HeaderMap, body: Bytes) -> Self

pub fn state<T: Send + Sync + 'static>(&self) -> Result<&T>

Shared application state registered with App::state

Answers 500 when no value of type T was registered: that is a programming error, not something the client can fix.

pub fn shutdown_signal(&self) -> Shutdown

Signal that fires when the server begins shutting down

Long-lived handlers (SSE streams, polling loops) select on it to end promptly: tokio::select! { _ = req.shutdown_signal().wait() => break, ... }.

pub fn try_state<T: Send + Sync + 'static>(&self) -> Option<&T>

Like Request::state, None when the type is not registered

pub fn cookies(&self) -> &Cookies

Get cookies from the request

pub fn form<T: DeserializeOwned>(&self) -> Result<T>

Parse an application/x-www-form-urlencoded body into a struct

Answers 415 for other content types and 400 for values that do not fit the target type.

pub fn form_data(&self) -> Result<Query>

The same body as decoded key/value access (+ and %XX decoded)

pub fn json<T: DeserializeOwned>(&self) -> Result<T>

Parse JSON body