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
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! warp 框架适配模块。
//!
//! 对应 warp 适配器,
//! 提供 GarrisonRouter + Filter extractor + GarrisonInterceptor 完整集成。
//!
//! ## 设计
//!
//! - `GarrisonRouter`:路由规则构建器,`route_protected` 注册路径 + 注解映射,`into_filter` 生成守卫 Filter
//! - `check_login()` / `check_role(role)` / `check_permission(perm)`:guard Filter,per-handler 鉴权
//! - `garrison_principal` / `tenant_context`:value-extracting Filter
//! - `impl Reply for GarrisonError` + `impl Reject for GarrisonRejection`:错误响应,复用 `response_parts()` 保证三框架一致
//!
//! ## 模块结构(Rule 25 接口隔离)
//!
//! - `mod.rs`:仅声明 `GarrisonRouter` / `GarrisonRejection` 结构体 + re-export
//! - `extractor`:value-extracting Filter(`garrison_principal` / `tenant_context`)
//! - `extractors`:guard Filter(`check_login` / `check_role` / `check_permission`)+ `Reject` / `Reply` impl
//! - [`router`]:`impl GarrisonRouter` + `impl Default`
//!
//! ## 使用示例
//!
//! ```ignore
//! use garrison::prelude::*;
//! use garrison::web_warp::{GarrisonRouter, check_login};
//! use warp::Filter;
//!
//! let router = GarrisonRouter::new(std::sync::Arc::new(GarrisonConfig::default_config()))
//! .route_protected("/api/user", Annotation::CheckLogin);
//!
//! let routes = warp::path("api")
//! .and(warp::path("user"))
//! .and(check_login(std::sync::Arc::new(GarrisonConfig::default_config())))
//! .map(|| "authenticated");
//! ```
use crateAnnotation;
use crateGarrisonConfig;
use crateGarrisonError;
use crateGarrisonInterceptor;
use HashMap;
use Arc;
/// 登录主体 extractor Filter(从 Authorization: Bearer `<token>` 解析 login_id)。
pub use garrison_principal;
/// 租户上下文 extractor Filter(需 `tenant-isolation` feature,从 X-Tenant-Id header 解析)。
pub use tenant_context;
/// `check_login` guard Filter:验证用户已登录。
pub use check_login;
/// `check_permission` guard Filter:验证用户持有指定权限。
pub use check_permission;
/// `check_role` guard Filter:验证用户持有指定角色。
pub use check_role;
// ============================================================================
// 结构体声明:实现见子模块 router / extractors
// ============================================================================
/// 包装 `GarrisonError` 以实现 `warp::reject::Reject`(warp 拒绝链需要 Reject 类型)。
///
/// `impl Reject` / `impl Reply` 见 [`extractors`]。
;
/// warp 路由器,收集鉴权路由规则并生成守卫 Filter。
///
/// 对应 axum 版 `GarrisonRouter`,API 对齐。
/// `impl GarrisonRouter` + `impl Default` 见 [`router`]。