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
//! Copyright (c) 2024-2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 管理器模块,提供全局管理器单例与编译期工厂注册。
//!
//! 对应 `SaManager`,
//! 统筹 DAO、配置、策略等组件的全局生命周期。
//!
//! ## 设计
//!
//! - `GarrisonManager` 持有 `Arc<GarrisonLogicDefault>` 全局单例(基于 `parking_lot::RwLock` 支持重复 init)
//! - `GarrisonLogicFactory` trait 通过 `inventory::submit!` 编译期注册
//! - 业务方调用 `GarrisonManager::init(dao, config, interface)` 注入依赖
//! - `GarrisonUtil::login(id)` 等静态方法委托到 `GARRISON_MANAGER` 单例
//!
//! ## 初始化流程
//!
//! ```ignore
//! use std::sync::Arc;
//! use garrison::prelude::*;
//!
//! // 1. 准备依赖
//! let dao: Arc<dyn GarrisonDao> = /* oxcache 或 dbnexus 实现 */;
//! let config = Arc::new(GarrisonConfig::default_config());
//! let interface: Arc<dyn GarrisonInterface> = Arc::new(MyInterface);
//!
//! // 2. 初始化全局管理器
//! GarrisonManager::init(dao, config, interface).unwrap();
//!
//! // 3. 使用静态 API(task_local 上下文由 middleware 设置)
//! let token = GarrisonUtil::login_simple("1001").await.unwrap();
//! ```
use crateGarrisonLogicDefault;
use crateStrategy;
use Lazy;
use RwLock;
use Arc;
use watch;
use JoinHandle;
// 显式 Manager API
// 启用 manager-explicit feature 后提供不依赖全局单例的 Manager struct。
// 工厂子系统(GarrisonLogicFactoryContext / GarrisonLogicFactoryEntry / garrison_logic_factory_default)。
// GarrisonManager 实现块(含 Drop impl)与 factory selector 辅助函数。
// Re-export factory 公共 API(保持原 mod.rs 路径兼容,如 crate::manager::GarrisonLogicFactoryEntry)。
pub use *;
/// 全局管理器,统筹 `GarrisonLogicDefault` 的生命周期。
///
/// 对应 `SaManager`,
/// 持有全局 `Arc<GarrisonLogicDefault>` 引用,提供静态方法入口。
///
/// # 初始化
///
/// 业务方启动时调用 `GarrisonManager::init(dao, config, interface)` 注入依赖。
/// 未初始化时调用 `GarrisonUtil::login(id)` 等返回 `GarrisonError::Session`。
/// 全局管理器单例。
///
/// 通过 `once_cell::sync::Lazy` 实现懒加载,
/// 首次访问时调用 `GarrisonManager::new()`。
pub static GARRISON_MANAGER: = new;