Struct Server

pub struct Server<L = HttpListener> { /* private fields */ }

A server can listen on a TCP socket.

Once listening, it will create a Request/Response pair for each incoming connection, and hand them to the provided handler.

Implementations

impl<L: NetworkListener> Server<L>

pub fn new(listener: L) -> Server<L>

Creates a new server with the provided handler.

pub fn keep_alive(&mut self, timeout: Option<Duration>)

Controls keep-alive for this server.

The timeout duration passed will be used to determine how long to keep the connection alive before dropping it.

Passing None will disable keep-alive.

Default is enabled with a 5 second timeout.

pub fn set_read_timeout(&mut self, dur: Option<Duration>)

Sets the read timeout for all Request reads.

pub fn set_write_timeout(&mut self, dur: Option<Duration>)

Sets the write timeout for all Response writes.

pub fn local_addr(&mut self) -> Result<SocketAddr>

Get the address that the server is listening on.

impl Server<HttpListener>

pub fn http<To: ToSocketAddrs>(addr: To) -> Result<Server<HttpListener>>

Creates a new server that will handle HttpStreams.

impl<S: SslServer + Clone + Send> Server<HttpsListener<S>>

pub fn https<A: ToSocketAddrs>( addr: A, ssl: S, ) -> Result<Server<HttpsListener<S>>>

Creates a new server that will handle HttpStreams over SSL.

You can use any SSL implementation, as long as implements mco_http::net::Ssl.

impl<L: NetworkListener + Send + 'static> Server<L>

pub fn handle<H: Handler + 'static>(self, handler: H) -> Result<Listening>

Binds to a socket and starts handling connections.

pub fn handle_threads<H: Handler + 'static>( self, handler: H, threads: usize, ) -> Result<Listening>

Binds to a socket and starts handling connections with the provided number of threads.

pub fn handle_accept(self, handler: fn(L::Stream)) -> Result<Listening>

Binds to a socket and starts handling connections.

Trait Implementations

impl<L: Debug> Debug for Server<L>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.