Struct Form 

pub struct Form<T>(pub T);

Deserializes an application/x-www-form-urlencoded request body into T.

The body counterpart to Query<T>, and the classic HTML form POST. Like Json<T> it consumes the body, so it must be the last handler argument.

Fails with 415 Unsupported Media Type when the content type is not application/x-www-form-urlencoded, and 400 Bad Request when the body does not deserialize into T.

Note + means a space here — this is form encoding. In a path segment + is a literal plus, which is why path decoding uses its own decoder.

use churust_core::{Churust, Form, TestClient};
use serde::Deserialize;
#[derive(Deserialize)]
struct Login { user: String }

let app = Churust::server()
    .routing(|r| {
        r.post("/login", |Form(l): Form<Login>| async move { l.user });
    })
    .build();

let res = TestClient::new(app)
    .post("/login")
    .header("content-type", "application/x-www-form-urlencoded")
    .body("user=ana")
    .send()
    .await;
assert_eq!(res.text(), "ana");

Tuple Fields

0: T

The deserialized form body.

Trait Implementations

impl<T> FromCall for Form<T>

where T: DeserializeOwned + Send,

fn from_call<'async_trait>( call: Call, ) -> Pin<Box<dyn Future<Output = Result<Self>> + Send + 'async_trait>>

where Self: 'async_trait,

Build Self by consuming the call, or return an Error (which the handler renders as the response).