Struct HttpServer

pub struct HttpServer { /* private fields */ }

The almighty HTTP server.

Guide:

1. Create the server

let mut server = HttpServer::new(HttpServerMode::MultiThread(HttpServerThreadPool::new(2)), "127.0.0.1:3000");

2. Insert handlers

server.insert_handler(|mut req, mut res| {
    res.set_status(HttpStatusStruct(200, "OK"));
    res.set_body(String::from("value"), String::from("Hello World!"));
    Ok(req, res)
});

3. Listen

server.listen(|| {
    println!("Server is listening at http://127.0.0.1:3000");
});

Implementations

impl HttpServer

pub fn new(mode: HttpServerMode, bind_adr: &str) -> Self

pub fn listen<F>(&self, cb: F)

where F: Fn(),

pub fn insert_handler<F>(&mut self, handler: F)

where F: Fn(HttpRequest, HttpResponse) -> Result<(HttpRequest, HttpResponse), (HttpRequest, HttpResponse, Box<dyn Error>)> + Send + Sync + 'static,

pub fn set_error_handler<F>(&mut self, handler: F)

where F: Fn(HttpRequest, HttpResponse, Box<dyn Error>) -> (HttpRequest, HttpResponse) + Send + Sync + 'static,

Custom error handling function

Example:

server.set_error_handler(|req, mut res, err| {
    res.set_status(HttpStatusStruct(500, "Interal Server Error"));
    res.text(format!("Unhandled exception: {:?}", err));
    (req, res)
});

Trait Implementations

impl Routing for HttpServer

fn insert_router(&mut self, router: Router)

impl ServeStatic for HttpServer

fn serve_static(&mut self, root_dir: Option<String>)

Serve files in the root_dir folder. Default root dir is public.