Struct micro_http_async::HttpServer

pub struct HttpServer {
    pub routes: Routes,
    // some fields omitted
}

HTTP Server

This struct stores the listener, which listens for incoming connections and handles them

Example:

let http_server = HttpServer::new("127.0.0.1", "8080").await.unwrap(); // Create a new http listener

Fields

routes: Routes

Implementations

impl HttpServer

pub async fn new(ip: &str, port: &str) -> Result<Self>

New

Create a new server, with a given IP and port

Example

let http_server = HttpServer::new("127.0.0.1", "8080").await.unwrap();

pub async fn new_tls(
    ip: &str,
    port: &str,
    cert_path: PathBuf,
    key_path: PathBuf
) -> Result<Self>

New TLS

Create a new server, with a given IP and port, and a TLS certificate and key

Example

let http_server = HttpServer::new_tls("127.0.0.1", "8080", "cert.pem", "key.pem").await.unwrap();

Note

The certificate and key files must be in PEM and KEY formats respectively. The key must not be encrypted.

pub async fn listen(&mut self) -> Result<(), &'static str>

Listen

Listen for new connections.

Run handle_connection upon connection.

Note

If you are using TLS, this function will not return until the server is shut down.

All errors will be printed to the console, instead of panicking.

pub async fn set_read_buffer_size(
    &mut self,
    size: usize
) -> Result<(), &'static str>

Set Read Buffer Size

Set the read buffer size for the server. The default value is 8192 bytes.