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,仅增强内部实现和类型转换能力
This commit is contained in:
@@ -5,10 +5,15 @@ import "fmt"
|
||||
// ExampleNew_withPointer 演示如何使用 New 函数传入指针
|
||||
// 传入指针时,修改会影响原始数据
|
||||
func ExampleNew_withPointer() {
|
||||
type Fruit struct {
|
||||
Name string
|
||||
}
|
||||
|
||||
type Person struct {
|
||||
Name string
|
||||
Age int
|
||||
Email *string
|
||||
Name string
|
||||
Age int
|
||||
Email *string
|
||||
Fruits []*Fruit
|
||||
}
|
||||
|
||||
email := "alice@example.com"
|
||||
@@ -22,11 +27,30 @@ func ExampleNew_withPointer() {
|
||||
// 对于指针字段,Set 会设置指针指向的值
|
||||
rfx.Set("Email", "bob@example.com")
|
||||
|
||||
// 切片成员为指针类型的场景
|
||||
apple := &Fruit{Name: "apple"}
|
||||
banana := &Fruit{Name: "banana"}
|
||||
cherry := &Fruit{Name: "cherry"}
|
||||
|
||||
// 传入指针切片
|
||||
rfx.Set("Fruits", []*Fruit{apple, banana, cherry})
|
||||
|
||||
// 也可以传入包含指针的 []any, 会复用指针地址
|
||||
rfx.Set("Fruits", []any{apple, banana, cherry})
|
||||
|
||||
// 修改外部指针元素, person.Fruits 中会看到相同变化(地址传递)
|
||||
apple.Name = "apple to grape"
|
||||
|
||||
// 原始数据已被修改(包括指针字段指向的值)
|
||||
fmt.Printf("Name: %s, Age: %d, Email: %s\n", person.Name, person.Age, *person.Email)
|
||||
fmt.Printf("Fruits: %s, %s, %s\n",
|
||||
person.Fruits[0].Name,
|
||||
person.Fruits[1].Name,
|
||||
person.Fruits[2].Name)
|
||||
|
||||
// Output:
|
||||
// Name: Bob, Age: 35, Email: bob@example.com
|
||||
// Fruits: apple to grape, banana, cherry
|
||||
}
|
||||
|
||||
// ExampleNew_withPointer_map 演示传入 map 指针
|
||||
|
||||
Reference in New Issue
Block a user