Crate form_data

Actix Form Data

A library for retrieving form data from Actix Web's multipart streams. It can stream uploaded files onto the filesystem (its main purpose), but it can also parse associated form data.

Example

 extern crate actix_web;
 extern crate form_data;
 extern crate futures;
 extern crate mime;

 use std::path::PathBuf;

 use actix_web::{http, server, App, AsyncResponder, HttpMessage, HttpRequest, HttpResponse, State};
 use form_data::{handle_multipart, Error, Field, FilenameGenerator, Form};
 use futures::Future;

 struct Gen;

 impl FilenameGenerator for Gen {
     fn next_filename(&self, _: &mime::Mime) -> Option<PathBuf> {
         let mut p = PathBuf::new();
         p.push("examples/filename.png");
         Some(p)
     }
 }

 fn upload(
     req: HttpRequest<Form>,
     state: State<Form>,
 ) -> Box<Future<Item = HttpResponse, Error = Error>> {
     handle_multipart(req.multipart(), state.clone())
         .map(|uploaded_content| {
             println!("Uploaded Content: {:?}", uploaded_content);
             HttpResponse::Created().finish()
         })
         .responder()
 }

 fn main() {
     let form = Form::new()
         .field("Hey", Field::text())
         .field(
             "Hi",
             Field::map()
                 .field("One", Field::int())
                 .field("Two", Field::float())
                 .finalize(),
         )
         .field("files", Field::array(Field::file(Gen)));

     println!("{:?}", form);

     server::new(move || {
         App::with_state(form.clone())
             .resource("/upload", |r| r.method(http::Method::POST).with2(upload))
     }).bind("127.0.0.1:8080")
         .unwrap();
         // .run()
 }

Structs

ArcExecutor	The executor type stored inside a Form
Array	A definition of an array of type Field to be parsed from form data.
Form	A structure that defines the fields expected in form data
Map	A definition of key-value pairs to be parsed from form data.

Enums

Error
Field	The field type represents a field in the form-data that is allowed to be parsed.
Value	The result of a succesfull parse through a given multipart stream.

Traits

FilenameGenerator

A trait for types that produce filenames for uploade files

Functions

handle_multipart

Handle multipart streams from Actix Web