body-parser

Body parsing plugins for the Iron web framework.

Example

```rust extern crate iron; extern crate bodyparser; extern crate persistent;

[macro_use]

extern crate serde_derive;

use persistent::Read; use iron::status; use iron::prelude::*;

[derive(Debug, Clone, Deserialize)]

struct MyStructure { a: String, b: Option, }

fn log_body(req: &mut Request) -> IronResult { let body = req.get::(); match body { Ok(Some(body)) => println!("Read body:\n{}", body), Ok(None) => println!("No body"), Err(err) => println!("Error: {:?}", err) }

let json_body = req.get::<bodyparser::Json>();
match json_body {
    Ok(Some(json_body)) => println!("Parsed body:\n{:?}", json_body),
    Ok(None) => println!("No body"),
    Err(err) => println!("Error: {:?}", err)
}

let struct_body = req.get::<bodyparser::Struct<MyStructure>>();
match struct_body {
    Ok(Some(struct_body)) => println!("Parsed body:\n{:?}", struct_body),
    Ok(None) => println!("No body"),
    Err(err) => println!("Error: {:?}", err)
}

Ok(Response::with(status::Ok))

}

const MAXBODYLENGTH: usize = 1024 * 1024 * 10;

// While the example is running, try the following curl commands and see how they are // logged by the Rust server process: // // curl -i "localhost:3000/" -H "application/json" -d '{"name":"jason","age":"2"}' // curl -i "localhost:3000/" -H "application/json" -d '{"a":"jason","b":"2"}' // curl -i "localhost:3000/" -H "application/json" -d '{"a":"jason"}' fn main() { let mut chain = Chain::new(logbody); chain.linkbefore(Read::::one(MAXBODYLENGTH)); Iron::new(chain).http("localhost:3000").unwrap(); } ```

Overview

body-parser is a part of Iron's core bundle. It contains:

Raw - performs body parsing to string with limiting.
Json - parses body into Json.
Struct - parses body into a struct using Serde.

Installation

If you're using a Cargo.toml to manage dependencies, just add body-parser to the toml:

```toml [dependencies.bodyparser]

git = "https://github.com/iron/body-parser.git" ```

Otherwise, cargo build, and the rlib will be in your target directory.

Documentation

Along with the online documentation, you can build a local copy with make doc.

Examples

Get Help

One of us (@reem, @zzmp, @theptrk, @mcreinhard) is usually on #iron on the mozilla irc. Come say hi and ask any questions you might have. We are also usually on #rust and #rust-webdev.