Struct Form 

pub struct Form<T>(pub T);

URL-encoded form data extractor.

Extracts application/x-www-form-urlencoded form data from the request body and deserializes it into the target type using serde.

Example

use fastapi_core::Form;
use serde::Deserialize;

#[derive(Deserialize)]
struct LoginForm {
    username: String,
    password: String,
}

async fn login(Form(form): Form<LoginForm>) -> impl IntoResponse {
    format!("Login attempt for: {}", form.username)
}

Content-Type

This extractor expects the Content-Type header to be application/x-www-form-urlencoded. Other content types will result in an error.

Error Responses

Returns 422 Unprocessable Entity when:

• Content-Type is not application/x-www-form-urlencoded
• Body cannot be read
• Deserialization fails

Tuple Fields

0: T

Implementations

impl<T> Form<T>

pub fn new(value: T) -> Self

Create a new Form wrapper.

pub fn into_inner(self) -> T

Unwrap the inner value.

Trait Implementations

impl<T: Clone> Clone for Form<T>

fn clone(&self) -> Form<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Form<T>

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

Formats the value using the given formatter.

impl<T> Deref for Form<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for Form<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T> FromRequest for Form<T>

where T: DeserializeOwned + Send + Sync + 'static,

type Error = FormExtractError

Error type when extraction fails.

async fn from_request( ctx: &RequestContext, req: &mut Request, ) -> Result<Self, Self::Error>

Extract a value from the request.