Struct tiny_http::Server

pub struct Server { /* fields omitted */ }

The main class of this library.

Destroying this object will immediatly close the listening socket and the reading part of all the client's connections. Requests that have already been returned by the recv() function will not close and the responses will be transferred to the client.

Methods

impl Server

pub fn http<A>(
    addr: A
) -> Result<Server, Box<dyn Error + Send + Sync + 'static>> where
    A: ToSocketAddrs, 

Shortcut for a simple server on a specific address.

pub fn new<A>(
    config: ServerConfig<A>
) -> Result<Server, Box<dyn Error + Send + Sync + 'static>> where
    A: ToSocketAddrs, 

Builds a new server that listens on the specified address.

Important traits for IncomingRequests<'a>

impl<'a> Iterator for IncomingRequests<'a> type Item = Request;

pub fn incoming_requests(&self) -> IncomingRequests

Returns an iterator for all the incoming requests.

The iterator will return None if the server socket is shutdown.

pub fn server_addr(&self) -> SocketAddr

Returns the address the server is listening to.

pub fn num_connections(&self) -> usize

Returns the number of clients currently connected to the server.

pub fn recv(&self) -> IoResult<Request>

Blocks until an HTTP request has been submitted and returns it.

pub fn recv_timeout(&self, timeout: Duration) -> IoResult<Option<Request>>

Same as recv() but doesn't block longer than timeout

pub fn try_recv(&self) -> IoResult<Option<Request>>

Same as recv() but doesn't block.

Trait Implementations

impl Drop for Server

fn drop(&mut self)

Executes the destructor for this type.