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
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! JSON 模块,提供 JSON 模板与序列化抽象。
//!
//! 对应 JSON 模板层,
//! 隔离具体 JSON 库(serde_json / simd-json 等)。
//!
//! ## 0.2.0 变更
//!
//! - `GarrisonJsonTemplate` 从 0.1.0 的占位 trait 转为具体 struct(持有 `serde_json::Value`)
//! - `GarrisonSerializerTemplate` 重命名为 `GarrisonSerializer`,方法签名保持兼容
//! - 新增 `GarrisonSerializerDefault` 默认实现(委托 serde_json)
use crateGarrisonResult;
/// JSON 模板 struct,持有解析后的 `serde_json::Value`,支持 `${key}` 占位符替换。
///
/// 用于"返回统一格式的登录响应"等场景(如 `{code: 0, msg: "ok", data: "${token}"}`)。
///
/// # 示例
///
/// ```
/// use garrison::json::GarrisonJsonTemplate;
/// use std::collections::HashMap;
///
/// let template = GarrisonJsonTemplate::new(r#"{"code":0,"msg":"${msg}"}"#).unwrap();
/// let mut params = HashMap::new();
/// params.insert("msg".to_string(), "ok".to_string());
/// let rendered = template.render(¶ms).unwrap();
/// assert!(rendered.contains("\"ok\""));
/// ```
/// 序列化抽象 trait,提供类型化的序列化/反序列化。
///
/// 对应 `SaSerializerTemplate`,0.1.0 的 `GarrisonSerializerTemplate` 重命名为此。
/// `GarrisonSerializer` 的默认实现,委托 `serde_json`。
///
/// 业务方可透明切换底层 JSON 库(如 simd-json)通过实现 `GarrisonSerializer` trait。
;