Struct rouille::Server

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

A listening server.

This struct is the more manual server creation API of rouille and can be used as an alternative to the start_server function.

The start_server function is just a shortcut for Server::new followed with run. See the documentation of the start_server function for more details about the handler.

Example

use rouille::Server;
use rouille::Response;

let server = Server::new("localhost:0", |request| {
    Response::text("hello world")
}).unwrap();
println!("Listening on {:?}", server.server_addr());
server.run();

Implementations

impl<F> Server<F> where
    F: Send + Sync + 'static + Fn(&Request) -> Response, 

pub fn new<A>(
    addr: A,
    handler: F
) -> Result<Server<F>, Box<dyn Error + Send + Sync>> where
    A: ToSocketAddrs, 

Builds a new Server object.

After this function returns, the HTTP server is listening.

Returns an error if there was an error while creating the listening socket, for example if the port is already in use.

pub fn pool_size(self, pool_size: usize) -> Self

Use a ThreadPool of the given size to process requests

pool_size must be greater than zero or this function will panic.

pub fn server_addr(&self) -> SocketAddr

Returns the address of the listening socket.

pub fn run(self)

Runs the server forever, or until the listening socket is somehow force-closed by the operating system.

pub fn poll(&self)

Processes all the client requests waiting to be processed, then returns.

This function executes very quickly, as each client requests that needs to be processed is processed in a separate thread.