Struct Multipart 

pub struct Multipart { /* private fields */ }

Extractor that parses multipart/form-data requests (commonly used with file uploads).

⚠️ Since extracting multipart form data from the request requires consuming the body, the Multipart extractor must be last if there are multiple extractors in a handler. See “the order of extractors”

Example

use axum::{
    extract::Multipart,
    routing::post,
    Router,
};
use futures_util::stream::StreamExt;

async fn upload(mut multipart: Multipart) {
    while let Some(mut field) = multipart.next_field().await.unwrap() {
        let name = field.name().unwrap().to_string();
        let data = field.bytes().await.unwrap();

        println!("Length of `{}` is {} bytes", name, data.len());
    }
}

let app = Router::new().route("/upload", post(upload));

Implementations

impl Multipart

pub async fn next_field(&mut self) -> Result<Option<Field<'_>>, MultipartError>

Yields the next Field if available.

Trait Implementations

impl Debug for Multipart

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

Formats the value using the given formatter.

impl<S, B> FromRequest<S, B> for Multipart

where B: Body + Send + 'static, <B as Body>::Data: Into<Bytes>, <B as Body>::Error: Into<Box<dyn Error + Send + Sync>>, S: Send + Sync,

type Rejection = MultipartRejection

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<B>, state: &'life0 S, ) -> Pin<Box<dyn Future<Output = Result<Multipart, <Multipart as FromRequest<S, B>>::Rejection>> + Send + 'async_trait>>

where 'life0: 'async_trait, Multipart: 'async_trait,

Perform the extraction.