Writer

Writer 用于写入内容到 Response:

#[async_trait]
pub trait Writer {
    async fn write(mut self, req: &mut Request, depot: &mut Depot, res: &mut Response);
}

相比于 Handler:

#[async_trait]
pub trait Handler: Send + Sync + 'static {
    async fn handle(&self, req: &mut Request, depot: &mut Depot, res: &mut Response, ctrl: &mut FlowCtrl);
}

他们直接的差别在于:

用途不一样, Writer 代表将具体的内容写入 Response, 由具体的内容实现, 比如字符串, 错误信息等. 而 Handler 是用于处理整个请求的.
Writer 是在 Handler 中被创建, 会在 write 函数调用时消耗自身, 是一次性调用. 而 Handler 是所有请求公用的;
Writer 可以作为 Handler 的返回的 Result 中的内容;
Writer 中不存在 FlowCtrl 参数, 无法控制整个请求的执行流程.

Scribe 实现了 Writer, 但是比 Writer 能实现的功能更少:

pub trait Scribe {
    fn render(self, res: &mut Response);
}

Scribe 的渲染函数只是写入数据到 Response 中, 这个过程是无法从 Request 或者 Depot 中获取信息的.

#Writer

Writer