表单参数提交介绍

什么是简单的表单参数提交

1.如果接口参数都是简单的键值对,没有嵌套关系,就是简单模式.

复杂表单参数提交 - 图1

什么是复杂的表单参数提交

1.表单参数存在嵌套关系,这种数据在 postman 都是以 raw 方式提交,本质上就是请求的表单参数头设置为:Content-Type: application/json

复杂表单参数提交 - 图2

ginskeleton 后台处理复杂表单数据

1.按照提交的数据格式,我们在表单参数验证器部分,定义接受的结构体,例如上图的参数我们在后台的接受参数就可以定义如下:

  1. type ViewEleCreateUpdate struct {
  2. FkBigScreenView float64 `form:"fk_big_screen_view" json:"fk_big_screen_view"`
  3. EleId string `form:"ele_id" json:"ele_id"`
  4. EleIdTitle string `form:"ele_id_title" json:"ele_id_title"`
  5. Status *float64 `form:"status" json:"status"`
  6. Remark string `form:"remark" json:"remark"`
  7. ChildrenTableDelIds string `form:"children_table_del_ids" json:"children_table_del_ids"`
  8. ChildrenTable []ChildrenTable `form:"children_table" json:"children_table"`
  9. }
  10. // 大屏界面元素的子表数据
  11. // 每种元素都有三个状态(1=正常;2=禁止;3=隐藏)
  12. // 被嵌套的数据请独立定义,这样的好处就是后续可以随意精准取出任意一部分
  13. type ChildrenTable struct {
  14. Id float64 `form:"id" json:"id"`
  15. FkBigScreenViewElement float64 `form:"fk_big_screen_view_element" json:"fk_big_screen_view_element"`
  16. FkBigScreenViewElementStatusName float64 `form:"fk_big_screen_view_element_status_name" json:"fk_big_screen_view_element_status_name"`
  17. Status *float64 `form:"status" json:"status"`
  18. Remark string `form:"remark" json:"remark"`
  19. }

接口验证器 ↓

1.复杂接口参数前端都是通过json格式提交.
2.go 语言代码接收语法是 context.ShouldBindJSON()

复杂表单参数提交 - 图3

接口验证器对应的数据类型 ↓

复杂表单参数提交 - 图4

在后续的控制器、model 获取子表数据

  1. # 在接口验证逻辑部分,通过参数验证后,我们将子表数据已经存储在上线文
  2. // 子表数据设置一个独立的键存储
  3. extraAddBindDataContext.Set(consts.ValidatorPrefix+"children_table_del_ids", v.ChildrenTable)
  4. // 那么后续的控制器、以及model都可以根据相关的键获取原始数据、断言为我们定义的子表数据类型继续操作
  5. var childrenTableData = c.MustGet(consts.ValidatorPrefix + "children_table_del_ids")
  6. // 获取子表数据断言为我们定义的子表数据类型
  7. // 这里需要注意:验证器验证参数ok调用了控制器,如果再验证器文件没有创建独立的数据类型文件夹(包),在控制器断言会形成包的嵌套、报错,这就是我们一开始将复杂数据类型创建独立的文件件定义的原因
  8. if subTableStr, ok := childrenTableData.([]data_type_for_create_edit.ChildrenTable); ok {
  9. // 这里就相当于获取了go语言切片数据
  10. // 继续批量存储、或者挨个遍历就行
  11. // .... 省略业务逻辑
  12. }