Commit Graph

7 Commits

Author SHA1 Message Date
7d17293df3 feat: 增强错误处理与示例 2025-12-09 20:06:56 +08:00
72d670be0b feat: 增强 map 大小写不敏感支持和函数重命名
- 新增 tryMapFieldKey 函数,返回 map 中实际存在的键(支持大小写转换)
- 优化 setFieldValue 方法,使用 tryMapFieldKey 查找已存在字段并更新
- 优化 setNestedValue 方法,修复嵌套 map 大小写处理和 interface 包装问题
- 重命名函数以提高代码清晰度:
  - tryStructField → tryStructFieldValue
  - tryMapField → tryMapFieldValue
  - tryMapFieldWithKey → tryMapFieldKey
- 新增 rfx_map_case_test.go 包含 16 个测试用例,覆盖基本、嵌套、边界等场景
2025-12-09 16:55:13 +08:00
bacec92841 feat: Append 方法支持 R 接口包装的指针类型
增强 setValue 函数,支持将 R 接口包装的指针值追加到非指针类型的切片中。当源值是指针但目标不是指针时,自动解引用后再赋值,使得 New(&item) 可以追加到 []Item 类型的切片。同时统一使用 Raw() 方法替代 Value() 方法名。
2025-12-08 17:24:45 +08:00
9e1bc55a8c feat: 增强类型转换能力和代码重构
核心改进:
1. 新增 normalizeInputValue 函数
   - 统一处理输入值的规范化,支持 R 接口、[]R 切片、reflect.Value
   - 避免重复封装,提升性能和类型安全性

2. 重构 getValueByPath 为独立函数
   - 从 rfx 方法提取为独立函数,提高代码复用性
   - 更好的职责分离,便于维护和测试

3. 显著增强 setValue 方法的类型转换能力
   - 支持切片类型转换:[]any -> []T,自动转换每个元素
   - 支持结构体类型转换:map -> struct 或 struct -> struct,按字段名匹配
   - 保持指针切片的引用语义,避免不必要的对象复制

4. 新增 tryMapField 函数
   - 支持 Map 键名的大小写不敏感访问
   - 首字母大写的键会自动尝试小写版本(如 "Host" -> "host")

5. 新增 lowercaseFirst 辅助函数
   - 用于首字母小写转换,配合 Map 键名查找

6. 更新测试用例
   - 新增指针切片的使用示例
   - 展示 []any 包含指针元素的场景

7. 文档全面更新
   - 新增"高级类型转换"章节,详细说明切片、结构体、指针切片等转换
   - 更新特性列表,突出增强的类型转换能力和 R 接口集成
   - 补充 Map 大小写不敏感访问的说明

影响范围:
- reflux.go: 使用 normalizeInputValue 统一输入处理
- rfx.go: 重构并增强 setValue、getValueByPath 等核心方法
- util.go: 新增多个辅助函数,代码行数增加 160 行
- rfx_example_test.go: 新增指针切片测试用例

向后兼容:完全兼容现有 API,仅增强内部实现和类型转换能力
2025-12-05 11:12:11 +08:00
cbe079ddcd feat: 支持反射设置指针类型字段
- 如果目标字段是指针类型,它会尝试直接赋值(如果类型兼容),或创建一个新指针并递归设置其指向的值。
  - `rfx_example_test.go` 中新增了测试用例,以验证对 `*string` 等指针字段的设置功能。
2025-12-04 11:25:44 +08:00
f9e7f8e781 fix: 修复深度克隆时 map/slice 中基本类型值被错误存储为指针的问题
- 提取 cloneSequence 函数统一处理 slice/array 克隆
- 提取 cloneElement 函数处理单个元素克隆
- 提取 needsDeepClone 函数判断是否需要深度克隆
- 减少代码重复,提高可维护性

为 ExampleNew_withValue* 系列测试添加 New() 后的输出,
清晰展示深度克隆后的初始状态和值类型正确性。
2025-12-03 10:20:15 +08:00
d9f178020a first commit 2025-12-02 19:52:29 +08:00