cernan 0.9.0

A telemetry and logging aggregation server.
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

//! Tiny, unassuming HTTP Server

extern crate tiny_http;

use std;
use thread;

/// HTTP request. Alias of `tiny_http::Request`.
pub type Request = tiny_http::Request;
/// HTTP response. Alias of `tiny_http::Response`.
pub type Response<'a> = tiny_http::Response<&'a [u8]>;
/// HTTP header. Alias of `tiny_http::Header`.
pub type Header = tiny_http::Header;
/// HTTP header field. Alias of `tiny_http::HeaderField`.
pub type HeaderField = tiny_http::HeaderField;
/// HTTP status code. Alias of `tiny_http::StatusCode`.
pub type StatusCode = tiny_http::StatusCode;

/// Simple single threaded HTTP request handler.
pub trait Handler: Sync + Send {
    /// Handler for a single HTTP request.
    fn handle(&self, request: Request) -> ();
}

/// Single threaded HTTP server.
pub struct Server {
    /// Thread handle for the operating HTTP server.
    thread: thread::ThreadHandle,
}

fn http_server<H>(
    poller: &thread::Poll,
    tiny_http_server: &tiny_http::Server,
    handler: &H,
) -> ()
where
    H: Handler,
{
    loop {
        let mut events = thread::Events::with_capacity(1024);
        match poller.poll(&mut events, Some(std::time::Duration::from_millis(5))) {
            Ok(num_events) if num_events > 0 => {
                break;
            }

            Ok(_) => match tiny_http_server
                .recv_timeout(std::time::Duration::from_millis(1000))
            {
                Ok(maybe_a_request) => if let Some(request) = maybe_a_request {
                    handler.handle(request);
                },

                Err(e) => {
                    panic!(format!("Failed during recv_timeout {:?}", e));
                }
            },

            Err(e) => {
                panic!(format!("Failed during poll {:?}", e));
            }
        };
    }
}

/// Single threaded HTTP server implementation.
impl Server {
    /// Create and start an HTTP server on the given host and port.
    pub fn new<H: Handler + 'static>(host_port: String, handler: H) -> Self {
        Server {
            thread: thread::spawn(move |poller| {
                let tiny_http_server = tiny_http::Server::http(host_port).unwrap();
                http_server(&poller, &tiny_http_server, &handler)
            }),
        }
    }
}

/// Graceful shutdown support for Server.
impl thread::Stoppable for Server {
    fn join(self) {
        self.thread.join();
    }

    fn shutdown(self) {
        self.thread.shutdown();
    }
}