Struct shs::Server

pub struct Server<E: Debug + Display> { /* private fields */ }

HTTP 1.1 server.

Example usage:

use anyhow::Error;
use fehler::throws;
use shs::{Request, Server};

#[throws]
fn handler(req: &mut Request) {
    todo!();
}

let mut server = Server::new("127.0.0.1:1234")?;
server.route("GET /hello", &handler)?;
server.launch()?;

Implementations

impl<E: Debug + Display + 'static> Server<E>

pub fn new(address: &str) -> Result<Server<E>, Error>

Create a new Server.

pub fn route( &mut self, route: &str, handler: &'static Handler<E> ) -> Result<(), Error>

Add a new route. The basic format is "METHOD /path". The path can contain parameters that start with a colon, for example "/resource/:key"; these parameters act as wild cards that can match any single path segment.

pub fn set_error_handler(&mut self, error_handler: &'static ErrorHandler<E>)

Set a custom error handler.

The default error handler:

• Logs the error
• If the error is NotFound, sets the status to NotFound and the body to “not found”
• If the error is Custom, sets the status to InternalServerError and the body to “internal server error”

pub fn launch(self) -> Result<(), Error>

Start the server.

pub fn test_request( &self, input: &TestRequest ) -> Result<TestResponse, RequestError<E>>

Send a fake request for testing.