feather-runtime 0.6.1

Web Server Runtime for Feather
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

use crate::http::{Request, Response};
use may::net::TcpStream;
use std::{io, sync::Arc};

/// The outcome of the application's request handling.
pub enum ServiceResult {
    /// A standard HTTP response. The Connection Handler will serialize and write this.
    Response(Response),
    /// The Service has taken ownership of the `TcpStream` (e.g., for WebSockets).
    /// The Connection Handler must terminate its loop immediately.
    Consumed,
}

/// The trait representing the user's core application logic.
pub trait Service: Send + Sync + 'static {
    /// Handles an incoming request, receiving the Request and the underlying stream.
    /// The stream is passed as an `Option` to allow the service to consume it for upgrades.
    fn handle(&self, req: Request, stream: Option<TcpStream>) -> io::Result<ServiceResult>;
}

pub type ArcService = Arc<dyn Service>;