Trait nickel::router::http_router::HttpRouter [−] [src]

pub trait HttpRouter<D> {
    fn add_route<M: Into<Matcher>, H: Middleware<D>>(&mut self, Method, M, H) -> &mut Self;

    fn get<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
    fn post<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
    fn put<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
    fn delete<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
    fn options<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
    fn patch<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self { ... }
}

Required Methods

`fn add_route<M: Into<Matcher>, H: Middleware<D>>(&mut self, Method, M, H) -> &mut Self`

Registers a handler to be used for a specified method. A handler can be anything implementing the RequestHandler trait.

Examples

#[macro_use] extern crate nickel;
extern crate hyper;
extern crate regex;

use nickel::{Nickel, HttpRouter};
use hyper::method::Method::{Get, Post, Put, Delete};
use regex::Regex;

fn main() {
    let mut server = Nickel::new();

    server.add_route(Get, "/foo", middleware! { "Get request! "});
    server.add_route(Post, "/foo", middleware! { |request|
        format!("Method is: {}", request.origin.method)
    });
    server.add_route(Put, "/foo", middleware! { |request|
        format!("Method is: {}", request.origin.method)
    });
    server.add_route(Delete, "/foo", middleware! { |request|
        format!("Method is: {}", request.origin.method)
    });

    // Regex path
    let regex = Regex::new("/(foo|bar)").unwrap();
    server.add_route(Get, regex, middleware! { "Regex Get request! "});
}

Provided Methods

`fn get<M: Into<Matcher>, H: Middleware<D>>(&mut self, matcher: M, handler: H) -> &mut Self`

Registers a handler to be used for a specific GET request. Handlers are assigned to paths and paths are allowed to contain variables and wildcards.

A handler added through this API will be attached to the default router. Consider creating the router middleware manually for advanced functionality.

Examples

#[macro_use] extern crate nickel;
use nickel::{Nickel, HttpRouter};

fn main() {
    let mut server = Nickel::new();

    //  without variables or wildcards
    server.get("/user", middleware! { "This matches /user" });

    // with variables
    server.get("/user/:userid", middleware! { |request|
        format!("This is user: {}", request.param("userid").unwrap())
    });

    // with simple wildcard
    server.get("/user/*/:userid", middleware! {
        "This matches /user/list/4711 but not /user/extended/list/4711"
    });

    // with double wildcard
    server.get("/user/**/:userid", middleware! {
        "This matches /user/list/4711 and also /user/extended/list/4711"
    });

    // with chained routes
    server
        .get("/foo", middleware! {
            "foo"
        })
        .get("/bar", middleware! {
            "bar"
        })
        .get("/baz", middleware! {
            "baz"
        })
        .get("/quux", middleware! {
            "quux"
        });
}

router! macro example

#[macro_use] extern crate nickel;
use nickel::Nickel;

fn main() {
    let router = router! {
        //  without variables or wildcards
        get "/user" => |_, response| {
            "This matches /user";
        }
        // with variables
        get "/user/:userid" => |request, response| {
            format!("This is user: {}", request.param("userid").unwrap())
        }
        // with simple wildcard
        get "/user/*/:userid" => |_, response| {
            ["This matches /user/list/4711",
             "NOT /user/extended/list/4711"];
        }
        // with double wildcard
        get "/user/**/:userid" => |_, response| {
            ["This matches /user/list/4711",
             "AND /user/extended/list/4711"];
        }
    };

    let mut server = Nickel::new();
    server.utilize(router);
}