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
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! actix-web 框架适配模块。
//!
//! 对应 actix-web 适配器,
//! 提供 GarrisonRouter + FromRequest extractor + GarrisonMiddleware 完整集成。
//!
//! ## 模块拆分(Rule 25 接口隔离)
//!
//! - `mod.rs`:pub struct 声明(GarrisonRouter/GarrisonMiddleware/GarrisonMiddlewareService/
//! RouteRule/CheckLogin/CheckRole/CheckPermission)+ pub mod 声明 + pub use re-export
//! - `error.rs`:`HeaderLookup for HeaderMap` + `ResponseError for GarrisonError` 实现
//! - `router.rs`:`GarrisonRouter` 方法 + `Default` 实现
//! - `middleware.rs`:`Transform` + `Service` trait 实现(GarrisonMiddleware/GarrisonMiddlewareService)
//! - `extractor.rs`:`FromRequest` extractor 实现(GarrisonPrincipal/CheckLogin/CheckRole/
//! CheckPermission/TenantContext)
//! - `mock.rs`:测试 mock(MockDao + MockInterface)
//! - `tests.rs`:集成测试
//!
//! ## 设计
//!
//! - `GarrisonRouter`:路由规则构建器,`route_protected` 注册路径 + 注解映射
//! - `GarrisonMiddleware`:actix-web middleware(Transform + Service),请求前调用 interceptor
//! - `CheckLogin` / `CheckRole` / `CheckPermission`:FromRequest extractors,per-handler 鉴权
//! - `ResponseError for GarrisonError`:错误响应,复用 `response_parts()` 保证三框架一致
//!
//! ## 使用示例
//!
//! ```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 crateGarrisonInterceptor;
use HashMap;
use Rc;
use Arc;
/// 登录主体 extractor(从 Authorization: Bearer `<token>` 解析 login_id)。
pub use GarrisonPrincipal;
// ============================================================================
// 路由规则 + 路由器 struct 声明(impl 见 router.rs)
// ============================================================================
/// 路由规则:路径 → 注解映射。
/// actix-web 路由器,收集鉴权路由规则并生成 middleware。
///
/// 对应 axum 版 `GarrisonRouter`,API 对齐。
// ============================================================================
// GarrisonMiddleware struct 声明(impl Transform/Service 见 middleware.rs)
// ============================================================================
/// actix-web middleware,提取 token + 调用 interceptor + 设置 task_local。
/// middleware service(Transform 生成的中间层)。
// ============================================================================
// FromRequest Extractor struct 声明(impl FromRequest 见 extractor.rs)
// ============================================================================
/// CheckLogin extractor:验证用户已登录。
///
/// 在 handler 参数中使用:
/// ```ignore
/// async fn handler(_auth: CheckLogin) -> &'static str { "ok" }
/// ```
;
/// CheckRole extractor:验证用户持有指定角色。
;
/// CheckPermission extractor:验证用户持有指定权限。
;