Struct Server

pub struct Server { /* private fields */ }

The main HTTP server - NestJS-like experience

Example

use elif_http::{Server, HttpConfig};
use elif_core::{Container, container::test_implementations::*};
use std::sync::Arc;
 
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = Arc::new(create_test_config());
    let database = Arc::new(TestDatabase::new()) as Arc<dyn elif_core::DatabaseConnection>;
     
    let container = Container::builder()
        .config(config)
        .database(database)
        .build()?;
         
    let server = Server::new(container, HttpConfig::default())?;
    server.listen("0.0.0.0:3000").await?;
     
    Ok(())
}

Implementations

impl Server

pub fn new(container: Container, config: HttpConfig) -> HttpResult<Self>

Create a new server instance

pub fn with_container( container: Arc<Container>, config: HttpConfig, ) -> HttpResult<Self>

Create a new server with existing Arc

pub fn use_router(&mut self, router: ElifRouter) -> &mut Self

Set custom routes using framework router

Example

use elif_http::{Server, ElifRouter, HttpConfig};
use elif_core::{Container, container::test_implementations::*};
use std::sync::Arc;
 
 
let config = Arc::new(create_test_config());
let database = Arc::new(TestDatabase::new()) as Arc<dyn elif_core::DatabaseConnection>;
 
let container = Container::builder()
    .config(config)
    .database(database)
    .build()?;
     
let mut server = Server::new(container, HttpConfig::default())?;
 
let router = ElifRouter::new()
    .get("/users", get_users)
    .post("/users", create_user);
 
server.use_router(router);

pub fn use_middleware<M>(&mut self, middleware: M) -> &mut Self

where M: Middleware + 'static,

Add middleware to the server

Example

use elif_http::{Server, HttpConfig};
use elif_core::{Container, container::test_implementations::*};
use std::sync::Arc;
 
 
let config = Arc::new(create_test_config());
let database = Arc::new(TestDatabase::new()) as Arc<dyn elif_core::DatabaseConnection>;
 
let container = Container::builder()
    .config(config)
    .database(database)
    .build()?;
     
let mut server = Server::new(container, HttpConfig::default())?;
server.use_middleware(LoggingMiddleware::default());

pub async fn listen<A: Into<String>>(self, addr: A) -> HttpResult<()>

Start the server on the specified address

Example

server.listen("0.0.0.0:3000").await?;

pub async fn listen_on(self, addr: SocketAddr) -> HttpResult<()>

Start the server on the specified SocketAddr