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();

Methods

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

fn new<A>(addr: A, handler: F) -> Result<Server<F>, Box<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.

fn server_addr(&self) -> SocketAddr

Returns the address of the listening socket.

fn run(self)

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

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.