Struct Server 

pub struct Server { /* private fields */ }

The main HTTP server - NestJS-like experience

Example

use elif_http::{Server, HttpConfig};
use elif_core::container::{IocContainer, ServiceBinder};
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut container = IocContainer::new();
    container.build().unwrap();
    let server = Server::new(container, HttpConfig::default())?;
    server.listen("0.0.0.0:3000").await?;
    Ok(())
}

Implementations

impl Server

pub fn new( container: IocContainer, config: HttpConfig, ) -> Result<Server, HttpError>

Create a new server instance

pub fn with_container( container: Arc<IocContainer>, config: HttpConfig, ) -> Result<Server, HttpError>

Create a new server with existing Arc

pub fn use_router(&mut self, router: Router) -> &mut Server

Set custom routes using framework router

Example

use elif_http::{Server, ElifRouter, HttpConfig, ElifRequest, HttpResult};
use elif_core::container::{IocContainer, ServiceBinder};
use std::sync::Arc;


let mut container = IocContainer::new();
container.build().unwrap();
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 Server

where M: Middleware + 'static,

Add middleware to the server

Example

use elif_http::{Server, HttpConfig};
use elif_core::container::{IocContainer, ServiceBinder};
use std::sync::Arc;


let mut container = IocContainer::new();
container.build().unwrap();
let mut server = Server::new(container, HttpConfig::default())?;
server.use_middleware(LoggingMiddleware::default());

pub fn debug_middleware(&mut self, enable: bool) -> &mut Server

Enable debug mode for detailed middleware execution logs

Example

use elif_http::{Server, HttpConfig};
use elif_core::container::{IocContainer, ServiceBinder};

let mut container = IocContainer::new();
container.build().unwrap();
let mut server = Server::new(container, HttpConfig::default())?;
server.debug_middleware(true);

pub fn inspect_middleware(&self)

Inspect all registered middleware and show execution order

Example

use elif_http::{Server, HttpConfig};
use elif_core::container::{IocContainer, ServiceBinder};

let mut container = IocContainer::new();
container.build().unwrap();
let server = Server::new(container, HttpConfig::default())?;
server.inspect_middleware();

pub fn use_profiler(&mut self) -> &mut Server

Add profiler middleware to log timing for each request

Example

use elif_http::{Server, HttpConfig};
use elif_core::container::{IocContainer, ServiceBinder};

let mut container = IocContainer::new();
container.build().unwrap();
let mut server = Server::new(container, HttpConfig::default())?;
server.use_profiler();

pub async fn listen<A>(self, addr: A) -> Result<(), HttpError>

where A: Into<String>,

Start the server on the specified address

Example

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

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

Start the server on the specified SocketAddr

pub fn container(&self) -> &Arc<IocContainer>

pub fn config(&self) -> &HttpConfig

pub fn router(&self) -> Option<&Router>

pub fn middleware(&self) -> &MiddlewarePipelineV2