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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 注解模块,定义鉴权注解枚举与 axum extractor。
//!
//! 对应 注解体系(`@SaCheckLogin` 等),
//! Rust 中以枚举变体表达(用于 router 中间件配置),
//! 同时提供 axum extractor(`CheckLogin` 等)用于 handler 参数提取。
//!
//! ## 设计
//!
//! - `Annotation` 枚举:保留用于 router 中间件配置
//! - marker trait(`RoleName` / `PermissionName` / `ModeSpec`):通过关联常量表达类型级参数
//! - extractor struct(`CheckLogin` 等):实现 `FromRequestParts`,仅在 `web-axum` feature 下编译
// ============================================================================
// Marker traits(用于泛型 extractor 的类型级参数,always compiled)
// ============================================================================
/// 角色 marker trait,通过关联常量 `NAME` 指定角色名。
///
/// 业务方定义类型实现此 trait,用作 `CheckRole<R>` 的类型参数:
/// ```ignore
/// struct AdminRole;
/// impl RoleName for AdminRole { const NAME: &'static str = "admin"; }
/// async fn handler(CheckRole::<AdminRole>: CheckRole<AdminRole>) { ... }
/// ```
/// 权限 marker trait,通过关联常量 `NAME` 指定权限名。
///
/// 业务方定义类型实现此 trait,用作 `CheckPermission<P>` 的类型参数。
/// 模式 marker trait,通过关联常量 `STRICT` 指定是否严格模式。
///
/// - `STRICT=true`:未登录抛 `NotLogin` 异常(严格模式)
/// - `STRICT=false`:未登录不抛错,允许匿名访问(宽松模式)
// ============================================================================
// 预定义模式(always compiled)
// ============================================================================
/// 严格模式:未登录抛 `NotLogin` 异常。
;
/// 宽松模式:未登录不抛错,允许匿名访问。
;
// ============================================================================
// Annotation 枚举(保留用于 router 中间件配置,always compiled)
// ============================================================================
/// 鉴权注解枚举,列出 16 个核心注解。
///
/// 对应 注解集合。
/// 注解逻辑组合模式。
///
/// 控制 `@CheckPermission` / `@CheckRole` 的多权限组合逻辑。
///
/// # 规则7 命名冲突记录
///
/// spec 要求命名为 `Mode`,但现有 `Mode<M: ModeSpec>` extractor struct(web-axum feature)
/// 已 re-export 为 `Mode`,会导致命名冲突。按规则11(惯例优先),保留现有 extractor 不变,
/// 新值级枚举命名为 `AnnotationMode`(语义更清晰:注解逻辑组合模式)。
// ============================================================================
// axum extractor(cfg(feature = "web-axum"))
// ============================================================================
// 具体实现已拆到 `extractors.rs`(规则 25:mod.rs 不放具体实现函数)。
pub use ;