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
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! 管理器模块,提供全局管理器单例与编译期工厂注册。
//!
//! `GarrisonManager` 统筹 DAO、配置、策略等组件的全局生命周期:持有
//! `Arc<GarrisonLogicDefault>` 全局单例(基于 `arc_swap::ArcSwapOption`,读路径无锁、支持
//! 重复 init);`GarrisonLogicFactory` trait 通过 `inventory::submit!` 编译期注册;业务方经
//! `GarrisonManager::builder().dao(dao).config(config).interface(interface).build().await`
//! 注入依赖;`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::builder()
//! .dao(dao)
//! .config(config)
//! .interface(interface)
//! .build()
//! .await
//! .unwrap();
//!
//! // 3. 使用静态 API(task_local 上下文由 middleware 设置)
//! let token = GarrisonUtil::login_simple("1001").await.unwrap();
//! ```
use crateGarrisonLogicDefault;
use crateStrategy;
use ArcSwapOption;
use RwLock;
use Arc;
use LazyLock;
use watch;
use JoinHandle;
// 显式 Manager API
// 启用 manager-explicit feature 后提供不依赖全局单例的 Manager struct。
// 工厂子系统(GarrisonLogicFactoryContext / GarrisonLogicFactoryEntry / garrison_logic_factory_default)。
// GarrisonManager 实现块(含 Drop impl)。
// 可组合的初始化 builder(GarrisonManagerBuilder / TaskHandles / build / build_explicit)。
// Re-export factory 公共 API(保持原 mod.rs 路径兼容,如 crate::manager::GarrisonLogicFactoryEntry)。
pub use *;
// Re-export builder 公共 API(crate::manager::GarrisonManagerBuilder)。
pub use GarrisonManagerBuilder;
/// 全局管理器,统筹 `GarrisonLogicDefault` 的生命周期。
///
/// 持有全局 `Arc<GarrisonLogicDefault>` 引用,提供静态方法入口。
///
/// # 初始化
///
/// 启动时调用 `GarrisonManager::builder().dao(dao).config(config).interface(interface).build().await`
/// 注入依赖。未初始化时调用 `GarrisonUtil::login(id)` 等返回 `GarrisonError::Session`
/// (错误码 `manager-not-init`,与 locales 键一致)。
///
/// # 并发写入契约
///
/// `logic` 与 `strategy` 是两个独立的 `ArcSwapOption`,单次 `store` 原子但两者成对非原子;
/// 并发 `build()` 可能产生 `(logic_B, strategy_A)` 错配对。该风险由 builder 内进程级
/// `BUILD_LOCK` 串行化单例写入段消除——不要绕过 builder 直接 `store` 全局单例字段。
/// 全局管理器单例(`LazyLock` 懒加载,首次访问时调用 `GarrisonManager::new()`)。
pub static GARRISON_MANAGER: = new;