mirror of
https://github.com/actix/actix-web.git
synced 2024-12-17 05:36:36 +00:00
77 lines
2 KiB
Markdown
77 lines
2 KiB
Markdown
# `actix-multipart`
|
|
|
|
> Multipart form support for Actix Web.
|
|
|
|
<!-- prettier-ignore-start -->
|
|
|
|
[![crates.io](https://img.shields.io/crates/v/actix-multipart?label=latest)](https://crates.io/crates/actix-multipart)
|
|
[![Documentation](https://docs.rs/actix-multipart/badge.svg?version=0.6.1)](https://docs.rs/actix-multipart/0.6.1)
|
|
![Version](https://img.shields.io/badge/rustc-1.72+-ab6000.svg)
|
|
![MIT or Apache 2.0 licensed](https://img.shields.io/crates/l/actix-multipart.svg)
|
|
<br />
|
|
[![dependency status](https://deps.rs/crate/actix-multipart/0.6.1/status.svg)](https://deps.rs/crate/actix-multipart/0.6.1)
|
|
[![Download](https://img.shields.io/crates/d/actix-multipart.svg)](https://crates.io/crates/actix-multipart)
|
|
[![Chat on Discord](https://img.shields.io/discord/771444961383153695?label=chat&logo=discord)](https://discord.gg/NWpN5mmg3x)
|
|
|
|
<!-- prettier-ignore-end -->
|
|
|
|
## Example
|
|
|
|
Dependencies:
|
|
|
|
```toml
|
|
[dependencies]
|
|
actix-multipart = "0.6"
|
|
actix-web = "4.5"
|
|
serde = { version = "1.0", features = ["derive"] }
|
|
```
|
|
|
|
Code:
|
|
|
|
```rust
|
|
use actix_web::{post, App, HttpServer, Responder};
|
|
|
|
use actix_multipart::form::{json::Json as MPJson, tempfile::TempFile, MultipartForm};
|
|
use serde::Deserialize;
|
|
|
|
#[derive(Debug, Deserialize)]
|
|
struct Metadata {
|
|
name: String,
|
|
}
|
|
|
|
#[derive(Debug, MultipartForm)]
|
|
struct UploadForm {
|
|
#[multipart(limit = "100MB")]
|
|
file: TempFile,
|
|
json: MPJson<Metadata>,
|
|
}
|
|
|
|
#[post("/videos")]
|
|
pub async fn post_video(MultipartForm(form): MultipartForm<UploadForm>) -> impl Responder {
|
|
format!(
|
|
"Uploaded file {}, with size: {}",
|
|
form.json.name, form.file.size
|
|
)
|
|
}
|
|
|
|
#[actix_web::main]
|
|
async fn main() -> std::io::Result<()> {
|
|
HttpServer::new(move || App::new().service(post_video))
|
|
.bind(("127.0.0.1", 8080))?
|
|
.run()
|
|
.await
|
|
}
|
|
```
|
|
|
|
Curl request :
|
|
|
|
```bash
|
|
curl -v --request POST \
|
|
--url http://localhost:8080/videos \
|
|
-F 'json={"name": "Cargo.lock"};type=application/json' \
|
|
-F file=@./Cargo.lock
|
|
```
|
|
|
|
### Examples
|
|
|
|
https://github.com/actix/examples/tree/master/forms/multipart
|