golang实战使用gin+xorm搭建go语言web框架restgo详解5.9 控制器controller编程示例

该章节我们以用户管理这一需求为例,阐述如何进行控制器编程。

首先我们分析用户管理需要的接口如下

用户管理模块api描述
编号	请求格式	接口描述	请求数据	响应数据
1	/user/query	根据姓名、电话等注册时间等最后登陆时间、角色等搜索和统计用户
2	/user/findOne	根据用户编号获取基础信息
3	/user/login	根据用户名、密码等进行登录操作
4	/user/register	用户注册操作
5	/user/resetpwd	用户重置密码
6	/user/edit	编辑用户基础信息
7	/user/profile	用户个人中心页面

我们以接口1为例说明

1、新建控制器,在controller文件夹下新建控制器UserController.go内容如下

package controller
import (
"restgo/restgo"
)
type UserController struct {
restgo.Controller
}

2、添加路由映射规则，对UserController结构体扩展如下方法

func (ctrl *UserController)Router(router *gin.Engine){
    r := router.Group("user")

r.Any("query",ctrl.query)
   }

3、实现query方法

func (ctrl *UserController)query(ctx *gin.Context){
   var userArg model.UserArg
   ctx.ShouldBindJSON(&userArg)
   //下面根据userArg拼接sql查询条件获取数据
   //var data = ...
   //最后响应数据列表到前端
   //restgo.ResultList(ctx,data,120)
}

4、重点说明:关于查询用的参数,我们不建议对参数名称采用特殊的处理,我们建议封装到一个结构体里面，如关于用户信息的查询参数,我们封装到UserArg结构体中。

type PageArg struct {
   Kword string `form:"kword"`
   Datefrom time.Time `form:"datefrom" time_format:"2006-01-02 15:04:05"`
   Dateto time.Time   `form:"dateto" time_format:"2006-01-02 15:04:05"`
   Pagesize int       `form:"pagesize" json:"pagesize"`
   Pagefrom int       `form:"pagefrom" json:"pagefrom"  validate:"gte=0"`
   Desc string        `form:"desc" json:"desc"`
   Asc  string        `form:"asc" json:"asc"`
}

type UserArg struct {
   PageArg
   ttype string `form:"ttype" json:"ttype"` 

//用于区分是注册时间还是登陆时间
}

//使用时候

当使用时,我们使用如下方法判断

var userArg model.UserArg

ctx.ShouldBindJSON(&userArg)
if len (userArg.Kword)>0{
   
}