Struct Form

pub struct Form<T>(pub T);

Available on crate feature form only.

Extractor that deserializes application/x-www-form-urlencoded requests into some type.

T is expected to implement serde::Deserialize.

Differences from axum::extract::Form

This extractor uses serde_html_form under-the-hood which supports multi-value items. These are sent by multiple <input> attributes of the same name (e.g. checkboxes) and <select>s with the multiple attribute. Those values can be collected into a Vec or other sequential container.

Example

use axum_extra::extract::Form;
use serde::Deserialize;

#[derive(Deserialize)]
struct Payload {
    #[serde(rename = "value")]
    values: Vec<String>,
}

async fn accept_form(Form(payload): Form<Payload>) {
    // ...
}

Tuple Fields

0: T

Trait Implementations

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

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

Returns a copy 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: Default> Default for Form<T>

fn default() -> Form<T>

Returns the “default value” for a type.

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, S> FromRequest<S> for Form<T>

where T: DeserializeOwned, S: Send + Sync,

type Rejection = FormRejection

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

fn from_request<'life0, 'async_trait>( req: Request, _state: &'life0 S, ) -> Pin<Box<dyn Future<Output = Result<Self, Self::Rejection>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Perform the extraction.

impl<T: Copy> Copy for Form<T>