Struct shs::Server

pub struct Server<T> { /* fields omitted */ }

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<T: Send + Sync + 'static> Server<T>

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

Create a new Server.

pub fn route(
    &mut self,
    route: &str,
    handler: &'static Handler<T>
) -> 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 state(&self) -> Arc<RwLock<T>>

Get the shared application state.

This is useful if you are spawning additional worker threads that will also use this state.

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

Start the server.

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

Send a fake request for testing.