params
A plugin for the Iron web framework that parses parameters from incoming requests from the following sources:
- JSON data (
Content-Type: application/json
) - URL-encoded GET parameters
- URL-encoded
Content-Type: application/x-www-form-urlencoded
parameters - Multipart form data (
Content-Type: multipart/form-data
)
This plugin combines all request parameters from these sources into a single params::Map
accessible through any Iron request using req.get_ref::<params::Params>()
. Working example:
// Visit `http://127.0.0.1:3000/?user[name]=Marie` to be greeted with a welcome message. Any other
// request will return a 404 error.
extern crate iron;
extern crate params;
use *;
You can perform custom request parameter deserialization by implementing params::FromValue
for any Sized
type. See src/conversion.rs
for inspiration!
This crate is fully documented, and we're working on hosting it at ironframework.io.
See examples/params.rs
for an interactive example.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.