rustful 0.9.0

A light HTTP framework, with some REST-like features and the ambition of being simple, modular and non-intrusive.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use router::{Router, Endpoint, InsertState, RouteState};
use context::MaybeUtf8Owned;
use context::hypermedia::Link;
use {Method, Handler};

///A router endpoint that assigns names to route variables.
///
///It's technically a single-item router, with the purpose of pairing route
///variable names with input values, but it can't contain other routers, since
///it has be at the end of a router chain to know what variables to use. It
///won't do any other routing work, so make sure to pair it with, at least, a
///path based router.
#[derive(Clone)]
pub struct Variables<H: Handler> {
    handler: H,
    variables: Vec<MaybeUtf8Owned>,
}

impl<H: Handler> Router for Variables<H> {
    type Handler = H;

    fn find<'a>(&'a self, _method: &Method, route: &mut RouteState) -> Endpoint<'a, H> {
        Endpoint {
            handler: Some(&self.handler),
            variables: route.variables(&self.variables),
            hyperlinks: vec![],
        }
    }

    fn hyperlinks<'a>(&'a self, mut base: Link<'a>) -> Vec<Link<'a>> {
        base.handler = Some(&self.handler);
        vec![base]
    }

    fn build<'a, R: Into<InsertState<'a, I>>, I: Iterator<Item = &'a [u8]>>(_method: Method, route: R, item: Self::Handler) -> Variables<H> {
        Variables {
            handler: item,
            variables: route.into().variables(),
        }
    }

    fn insert<'a, R: Into<InsertState<'a, I>>, I: Iterator<Item = &'a [u8]>>(&mut self, _method: Method, route: R, item: Self::Handler) {
        self.handler = item;
        self.variables = route.into().variables();
    }

    fn insert_router<'a, R: Into<InsertState<'a, I>>, I: Clone + Iterator<Item = &'a [u8]>>(&mut self, route: R, mut router: Variables<H>) {
        router.prefix(route);
        *self = router;
    }

    fn prefix<'a, R: Into<InsertState<'a, I>>, I: Clone + Iterator<Item = &'a [u8]>>(&mut self, route: R) {
        let mut new_vars = route.into().variables();
        new_vars.extend(self.variables.drain(..));
        self.variables = new_vars;
    }
}

impl<H: Handler + Default> Default for Variables<H> {
    fn default() -> Variables<H> {
        Variables {
            handler: H::default(),
            variables: vec![],
        }
    }
}