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
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! actix-web 框架适配模块:GarrisonRouter + FromRequest extractor + GarrisonMiddleware 完整集成。
//!
//! 模块拆分(接口隔离):`router.rs` 路由构建器、`middleware.rs` Transform/Service、
//! `extractor.rs` per-handler 鉴权、`error.rs` HeaderLookup + ResponseError、`mock.rs`/`tests.rs` 测试。
//!
//! ## 使用示例
//!
//! ```ignore
//! use garrison::prelude::*;
//! use garrison::web_actix::{GarrisonRouter, CheckLogin};
//! use actix_web::{App, HttpServer, web};
//!
//! async fn protected_handler(_auth: CheckLogin) -> &'static str {
//! "authenticated"
//! }
//!
//! let router = GarrisonRouter::new(std::sync::Arc::new(GarrisonConfig::default_config()))
//! .route_protected("/api/user", Annotation::CheckLogin);
//!
//! App::new()
//! .route("/api/user", web::get().to(protected_handler))
//! .wrap(router.into_middleware());
//! ```
use crateAnnotation;
use crateGarrisonConfig;
use crateTenantResolver;
use crateGarrisonInterceptor;
use HashMap;
use Rc;
use Arc;
/// 登录主体 extractor(从 Authorization: Bearer `<token>` 解析 login_id)。
pub use GarrisonPrincipal;
/// X-Request-ID 中间件(Transform):提取 / 生成 / 回传请求标识。
pub use ;
// 路由规则 + 路由器 struct 声明(impl 见 router.rs)
/// 路由规则:路径 → 注解映射。
/// actix-web 路由器,收集鉴权路由规则并生成 middleware。
///
/// 对应 axum 版 `GarrisonRouter`,API 对齐。
// GarrisonMiddleware struct 声明(impl Transform/Service 见 middleware.rs)
/// actix-web middleware:提取 token + 解析租户 + 调用 interceptor + 设置 task_local。
///
/// 配置 [`TenantResolver`]([`GarrisonRouter::with_tenant_resolver`])时先解析 `TenantContext` 并进入
/// `TENANT.scope`,使 tenant-isolation 下的 `check_permission`/`check_role` 拿到租户上下文(避免 fail-closed 拒绝)。
/// middleware service(Transform 生成的中间层)。
// FromRequest Extractor struct 声明(impl FromRequest 见 extractor.rs)
/// CheckLogin extractor:验证用户已登录。
///
/// 在 handler 参数中使用:
/// ```ignore
/// async fn handler(_auth: CheckLogin) -> &'static str { "ok" }
/// ```
;
/// CheckRole extractor:验证用户持有指定角色。
///
/// 角色名通过 `web::Data<RequiredRole>` 服务端配置。
;
/// CheckPermission extractor:验证用户持有指定权限。
///
/// 权限名通过 `web::Data<RequiredPermission>` 服务端配置。
;
/// CheckRole 服务端配置:路由注册时声明所需角色。
///
/// 通过 `web::Data::new(RequiredRole("admin".into()))` 注入,角色名禁止客户端控制。
///
/// # 使用
///
/// ```ignore
/// use garrison::web_actix::RequiredRole;
/// App::new()
/// .app_data(web::Data::new(RequiredRole("admin".to_string())))
/// .route("/admin", web::get().to(admin_handler))
/// ```
;
/// CheckPermission 服务端配置:路由注册时声明所需权限。
///
/// 通过 `web::Data::new(RequiredPermission("user:read".into()))` 注入,权限名禁止客户端控制。
///
/// # 使用
///
/// ```ignore
/// use garrison::web_actix::RequiredPermission;
/// App::new()
/// .app_data(web::Data::new(RequiredPermission("user:read".to_string())))
/// .route("/data", web::get().to(data_handler))
/// ```
;