serv 0.2.0

oneshot-style HTTP API builder
Documentation 
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

extern crate bytes;
#[macro_use]
extern crate error_chain;
extern crate futures;
extern crate hyper;
#[macro_use]
extern crate log;
extern crate serde;
#[macro_use]
extern crate serde_derive;
#[cfg(feature = "fst")]
extern crate fst;
extern crate http;
extern crate serde_json;
extern crate serde_qs;
extern crate tokio;
extern crate tokio_current_thread;
extern crate tokio_io;
#[cfg(feature = "uds")]
extern crate tokio_uds;
extern crate url;

pub mod error {
    use super::*;

    error_chain!{
        foreign_links {
            Hyper(hyper::Error);
            Http(http::Error);
            Io(std::io::Error);
        }

        errors {
            UnexpectedMethod(m: hyper::Method) {
                description("badarg")
            }
            InvalidEndpoint {
                description("invalid_endpoint")
            }
            DecodeJson(e: serde_json::Error) {
                description("badarg")
            }
            EncodeJson(e: serde_json::Error) {
                description("internal")
            }
            DecodeQs(e: serde_qs::Error) {
                description("badarg")
            }
        }
    }
}

type SyncObj<T> = std::rc::Rc<T>;

pub mod async;
pub mod reply;
pub mod server;
pub mod sync;

pub use error::{Error, ErrorKind};
pub use server::Server;
use std::fmt::Debug;

use futures::future::*;
use futures::*;
use hyper::header::*;
use hyper::service::Service;
use hyper::{Body, Request, Response};

pub fn resp_err() -> Response<Body> {
    Response::builder()
        .status(hyper::StatusCode::BAD_REQUEST)
        .body(Body::empty())
        .unwrap_or_else(|_| Response::new(Body::empty()))
}

pub fn resp_serv_err<E>(e: E, status: hyper::StatusCode) -> Response<Body>
where
    E: Debug + std::error::Error,
{
    let reply = reply::ServiceReply::<(), E>::from(e);
    let encoded = match serde_json::to_vec(&reply) {
        Ok(v) => v,
        Err(_e) => return resp_err(),
    };

    Response::builder()
        .header(ACCESS_CONTROL_ALLOW_ORIGIN, "*")
        .status(status)
        .body(Body::from(encoded))
        .unwrap_or_else(|_| Response::new(Body::empty()))
}

pub type HyperFuture = Box<Future<Item = Response<Body>, Error = hyper::Error>>;
pub type HyperService =
    Box<Service<ReqBody = Body, ResBody = Body, Error = hyper::Error, Future = HyperFuture>>;
pub type HyperServiceSend = Box<
    Service<
        ReqBody = Body,
        ResBody = Body,
        Error = hyper::Error,
        Future = Box<Future<Item = Response<Body>, Error = hyper::Error> + Send>,
    >,
>;

/// parse API req from qs/body
fn parse_req<R>(req: Request<Body>) -> Box<Future<Item = R, Error = Error>>
where
    R: for<'de> serde::Deserialize<'de> + 'static,
{
    use hyper::Method;
    match req.method().clone() {
        Method::GET | Method::DELETE => {
            let qs = req.uri().query().unwrap_or("");
            let req: Result<R, Error> =
                serde_qs::from_str(qs).map_err(|e| ErrorKind::DecodeQs(e).into());
            Box::new(result(req))
        }
        Method::PUT | Method::POST => {
            let buf = Vec::new();

            let f = req
                .into_body()
                .map_err(Error::from)
                .fold(buf, |mut buf, chunk| {
                    buf.extend_from_slice(&chunk);
                    //TODO: move to config?
                    if buf.len() > 1024 * 1024 * 4 {
                        Err(Error::from("body too large"))
                    } else {
                        Ok(buf)
                    }
                })
                .and_then(move |chunk: Vec<u8>| {
                    serde_json::from_slice(&chunk).map_err(|e| ErrorKind::DecodeJson(e).into())
                });
            Box::new(f)
        }
        m => Box::new(err(ErrorKind::UnexpectedMethod(m).into())),
    }
}

#[derive(Serialize, Deserialize, Default, Clone, Copy, Debug)]
pub struct Empty {}