Trait Handler

Source

pub trait Handler:
    Send
    + Sync
    + 'static {
    // Required method
    fn handle(&self, call: Call) -> HandlerFuture;
}

Expand description

Anything that can handle a Call and produce a Response.

This is the type-erased shape the Router stores (as a BoxHandler). You rarely implement it by hand — async closures become Handlers through IntoHandler — but you can implement it directly for a type that needs to carry state.

use churust_core::{Call, Handler, Response, IntoResponse, handler::HandlerFuture};
use http::{HeaderMap, Method};
use bytes::Bytes;

struct Greeter;
impl Handler for Greeter {
    fn handle(&self, _call: Call) -> HandlerFuture {
        Box::pin(async { "hi".into_response() })
    }
}
let call = Call::new(Method::GET, "/".parse().unwrap(), HeaderMap::new(), Bytes::new());
let res = Greeter.handle(call).await;
assert_eq!(res.body.as_slice(), Some(&b"hi"[..]));