silent 2.16.1

Silent Web Framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

use async_trait::async_trait;

use crate::Request;

use http::{Uri as HttpUri, Version as HttpVersion};

/// Path 萃取器：支持从路径参数中解析到单值或结构体
/// - 单值：当仅有一个路径参数时，使用 from_str_val 解析到目标类型
/// - 结构体：当存在多个路径参数时，按字段名匹配填充
pub struct Path<T>(pub T);

/// Query 萃取器：从 URL 查询参数解析为 T
pub struct Query<T>(pub T);

/// Json 萃取器：从 application/json 解析为 T（带缓存）
pub struct Json<T>(pub T);

/// Form 萃取器：从表单解析为 T
pub struct Form<T>(pub T);

/// State 萃取器：从应用级共享状态中提取 T
pub struct State<T>(pub T);

#[deprecated(
    since = "2.16.0",
    note = "请使用 State<T> 代替，Configs<T> 将在 v2.18.0 移除"
)]
pub struct Configs<T>(pub T);

/// 从 Extensions 中提取扩展
pub struct Extension<T>(pub T);

/// 头部类型化提取（等价 axum 的 TypedHeader）
pub struct TypedHeader<H>(pub H);

pub struct Method(pub crate::Method);
pub struct Uri(pub HttpUri);
pub struct Version(pub HttpVersion);
pub struct RemoteAddr(pub crate::core::remote_addr::RemoteAddr);

/// Request 便捷扩展：通用萃取
#[async_trait]
pub trait RequestExt {
    async fn extract<T>(&mut self) -> Result<T, T::Rejection>
    where
        T: super::FromRequest + Send + 'static;
}

#[async_trait]
impl RequestExt for Request {
    async fn extract<T>(&mut self) -> Result<T, T::Rejection>
    where
        T: super::FromRequest + Send + 'static,
    {
        T::from_request(self).await
    }
}