Binding 组件

smartwalle · · 929 次点击    
这是一个分享于 的资源,其中的信息可能已经有所发展或是发生改变。
https://github.com/smartwalle/binding ## Binding Binding 是一个利用 Golang 的反射机制,将 map 对象的数据映射到 struct 的工具包,可用于将 HTTP 请求参数映射到指定的 struct。 业界关于将 HTTP 参数绑定到 struct 的工具库虽然已经有很多,但是大多都只是对数据进行简单的映射,缺少灵活的控制,本工具来自于实践,或者也适用于你。 #### 例子 ``` import ( "fmt" "testing" ) type Human struct { Name string `form:"name"` Age int `form:"age"` Birthday time.Time `form:"birthday"` } func (this *Human) CleanedBirthday(n string) (time.Time, error) { return time.Parse("2006-01-02", n) } type Student struct { Human Number int `form:"number"` Class string `form:"class"` } func (this *Student) DefaultClass() string { return "Class one" } var formData = map[string]interface{}{"name": "Yangfeng", "age": "12", "number": "9", "birthday": "2016-06-12"} func TestSample(t *testing.T) { // 绑定 var s *Student var err = BindWithTag(formData, &s, "form") if err != nil { fmt.Println("绑定失败") } fmt.Println(s) } ``` #### 自定义 Tag 名称 上面代码是一个将 map 对象和 struct 进行绑定的简单例子, formData 是我们要绑定的数据源,我们要它的数据绑定到 Student 结构体上,除了 BindWithTag 函数有第三个参数外,和其它用于数据绑定的组件没有什么区别,这也是本组件的灵活点之一,可以任意设定结构体属性和数据源数据对应的关系。 #### 默认值 (Default 方法) 如果您仔细看,会发现结构体 Student 有一个 DefaultClass 的方法,该方法用于返回 Student 结构体的 Class 属性的默认值。对于一些场景,比如 HTTP 请求,可能请求的数据源中并不存在某些参数,但是我们又需要这些参数,所以,你可以通过这种方式来指定某一个属性的默认值。具体的方法为给该结构体添加一个以 Default+属性名 的方法,该方法需要返回一个具体的值。当在被绑定的数据源中找不到对应的关系,就会调用该方法获取一个默认的值。 #### 清理数据 (Cleaned 方法) 对于一个未知的数据源,里面的数据可能是乱七八糟的,对于我们来讲有太多未知的因素,如果在绑定的时候就能够清理一次或者转换为我们需要的数据类型,着实可以减少不少 if 语句。 上面的代码中,结构体 Human 有一个名叫 CleanedBirthday 的方法,就是用于“清理” Birthday 属性的值。数据源中的 birthday 是一个字符串,我们需要将其转换为 time.Time 对象,所以特意添加了一个方法来对数据进行加工。注意方法名称为 Cleaned+属性名,方法有一个参数,为原始数据,其类型需要和原始数据类型保持一致。Cleaned 相关的方法会返回两个数据,一个是“加工”之后的数据,另一个是满足 error 接口的对象。如果返回的 error 不为空,则会在 Bind 方法返回该错误。 #### 特别说明 * 通过 Default 方法获取到的属性值,不会再经过 Cleaned 方法进行加工; * Cleaned 方法返回的数据类型必须和对应属性的类型一致; * 如果数据源中的数据类型和结构体的属性数据类型不一致,将把数据源的数据类型转换为结构体对应属性的类型; * 支持 Slice,详见 test。 ## HTTP 关于和 HTTP 参数进行绑定,可以参考 [FORM](https://github.com/smartwalle/form) 组件,该组件是本组件的一个延伸。

入群交流(和以上内容无关):加入Go大咖交流群,免费领全套学习资料或添加微信:muxilin131420 备注:入群;或加QQ群:729884609

929 次点击  
加入收藏 微博
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传