各种场景的业务逻辑处理:
•创建用户
•删除用户
•更新用户
•查询用户列表
•查询指定用户的信息
handler中主要做解析参数,返回数据操作,简单的逻辑也可以在handler中做,像新增用户,删除用户,更新用户。查询用户列表,查询指定用户的信息放在service中。
配置路由信息:
需要先在router/router.go文件中,配置路由消息:
func Load(g *gin.Engine, mw …gin.HandlerFunc) *gin.Engine {
···
// 用户路由设置
u := g.Group(“/v1/user”)
{
u.POST(“”, user.Create) // 创建用户
u.DELETE(“/:id”, user.Delete) // 删除用户
u.PUT(“/:id”, user.Update) // 更新用户
u.GET(“”, user.List) // 用户列表
u.GET(“/:username”, user.Get) // 获取指定用户的详细信息
}
···
return g
}
注册新的错误码:
在pkg/errno/code.go文件中,新增如下错误码:
var
(
// Common errors 常见错误
…
ErrValidation = &Errno{Code: 20001, Message: “Validation failed.”} //验证错误
ErrDatabase=&Errno{Code: 20002, Message: “Database error.”} //数据库错误
ErrToken = &Errno{Code: 20003, Message: “Error occurred while signing the JSON web token.”} //Token错误
// user errors 用户错误
ErrEncrypt = &Errno{Code: 20101, Message: “Error occurred while encrypting the user password.”} //加密错误
ErrTokenInvalid = &Errno{Code: 20103, Message: “The token was invalid.”}
//Token已禁用
ErrPasswordIncorrect = &Errno{Code: 20104, Message: “The password was incorrect.”} //密码不正确
)
新增用户:
更新handle/user/create/.go中Create()的逻辑:
创建用户逻辑:
1.从HTTP消息体获取参数(用户名和密码)获取入参的ID:util.GetReqID©
2.参数校验
3.加密密码 Encrypt()函数引用auth.Encrypt()来进行密码加密
4.在数据库中添加数据记录
5.返回结果(这里是用户名)
删除用户:
删除时,首先根据 URL 路径 DELETE http://127.0.0.1/v1/user/1 解析出 id 的值 1,该 id 实际上就是数据库中的 id 索引,调用 model.DeleteUser() 函数删除。
// Delete delete an user by the user identifier.
func Delete(c *gin.Context) {
userId, _ := strconv.Atoi(c.Param(“id”))//从路径中解析出来的id(http://127.0.0.1/v1/user/1)Param()返回URL的参数值
if err := model.DeleteUser(uint64(userId)); err != nil {
SendResponse(c, errno.ErrDatabase, nil)
return
}
SendResponse(c, nil, nil)
}
更新用户:
更新用户逻辑跟创建用户差不多,在更新完数据库字段后,需要指定 gorm model 中的 id 字段的值,因为 gorm 在更新时默认是按照 id 来匹配记录的。通过解析 PUT http://127.0.0.1/v1/user/1 来获取 id。
查询用户列表:
1、查询一个 REST 资源列表,通常需要做分页,如果不做分页返回的列表过多,会导致 API 响应很慢,前端体验也不好。本例中的查询函数做了分页,收到的请求中传入的 offset 和 limit 参数,分别对应于 MySQL 的 offset 和 limit。
service.ListUser() 函数用来做具体的查询处理。
2、另外使用 sync.Mutex 是因为在并发处理中,更新同一个变量为了保证数据一致性,通常需要做锁处理。
3、使用 IdMap 是因为查询的列表通常需要按时间顺序进行排序,一般数据库查询后的列表已经排过序了,但是为了减少延时,程序中用了并发,这时候会打乱排序,所以通过 IdMap 来记录并发处理前的顺序,处理后再重新复位。
获取指定用户详细信息:
获取指定用户信息时,首先根据 URL 路径 GET http://127.0.0.1/v1/user/admin 解析出 username 的值 admin,然后调用 model.GetUser() 函数查询该用户的数据库记录并返回。