前面第10节课内容中已经学习开发完成了管理员登陆功能。本节课我们将继续学习开发完成管理员信息查询功能、管理员退出功能
管理员信息查询功能
请求及路由映射
管理员信息查询接口
接口名称:获取管理员信息。
使用场景:管理员登陆系统时,通过该接口查询获取管理员信息。服务器接收到请求后,首先从Session中获取用户信息,如果能够获取到管理员信息,则将数据组合后进行返回;如果Session获取不到管理员信息,则跳转到管理员登陆页面。
请求Url:接口文档之前已经介绍过,使用小幺鸡平台来生成接口文档,小幺鸡接口文档地址:http://www.xiaoyaoji.cn/doc/ywBfq1vWM。管理员信息查询接口:/admin/info。
Request请求类型: GET请求类型。
数据类型:X-WWW-FORM-URLENCODED。
响应类型:JSON格式。
路由控制器绑定服务端使用之前已经学习过的mvc包绑定控制器自动解析路由请求。设置解析mvc管理员控制器代码如下所示:
adminService := service.NewAdminService(engine)
admin := mvc.New(app.Party("/admin"))
admin.Register(
adminService,
sessManager.Start,
)
admin.Handle(new(controller.AdminController))
AdminController负责处理管理员模块的请求业务逻辑处理,具体的请求路由的自动映射关系在之前的课程中我们已经介绍过:
使用app.Party("/admin")路由组来解析管理员模块的请求
请求url为info,请求类型为Get。因此,在AdminController中声明GetInfo方法来处理获取管理员信息的请求。
请求处理返回值类型为mvc.Result,该类型是专门用于处理请求的返回值类型。在使用过程中,还可以使用mvc.Response以及mvc.View。
Controller业务逻辑处理
在GetInfo方法中处理/admin/info的业务逻辑主要步骤如下:
Session中获取管理员信息
userByte := ac.Session.Get(ADMIN)
如果获取不到管理员信息,组装数据进行返回,返回数据包含一下字段:
```
mvc.Response{
Object: map[string]interface{}{
"status": utils.RECODE_UNLOGIN,//未登陆
"type": utils.EEROR_UNLOGIN,//未登陆类型
"message": utils.Recode2Text(utils.EEROR_UNLOGIN),//提示语未登陆
}
```
如果能够获取到管理员信息数据,将管理员数据信息进行组装并返回,返回数据包含以下字段:
mvc.Response{
Object: map[string]interface{}{
"status": utils.RECODE_OK,
"data": admin.AdminToRespDesc(),
},
}
其中返回的data字段中包含的即是管理员的相关信息。此处,我们通过AdminToRespDesc方法将管理员结构体数据转化成所需要的键值信息,该方法定义如下:
func (this *Admin) AdminToRespDesc() interface{} {
respDesc := map[string]interface{}{
"user_name": this.AdminName,
"id": this.AdminId,
"create_time": this.CreateTime,
"status": this.Status,
"avatar": this.Avatar,
"city": this.CityName,
"admin": "管理员",
}
return respDesc
}
adminService查询管理员记录信息
GetByAdminNameAndPassword查询用户信息在开发用户登陆功能时,我们调用过该方法,该方法是使用我们的数据库操作引擎来查询管理员用户信息,并来返回内容并且将查询后的用户信息保存到了session当中:
ac.engine.Where(" user_name = ? and pwd = ? ", username, password).Get(&admin)
条件查询使用两个语法:
where:添加查询限制条件
get:将查询结果赋值给结构体变量
SQL语句我们使用数据库引擎操作查询管理员信息,其实最终执行的SQL语句如下:
select * from admin where user_name = '' and pwd = ''
管理员退出功能
请求及路由映射
管理员退出接口:
接口详细内容可以参考小幺鸡接口文档:http://www.xiaoyaoji.cn/doc/yyRPCzC5M
路由控制器绑定
管理员退出功能依然是Get请求,接口url为singout,因此我们在AdminController中定义如下方法用于处理用户退出功能请求:
func (ac *AdminController) GetSingout() mvc.Result {
//删除session,下次需要从新登录
ac.Session.Delete(ADMIN);
return mvc.Response{
Object: map[string]interface{}{
"status": utils.RECODE_OK,
"success": utils.Recode2Text(utils.RESPMSG_SIGNOUT),
},
}
}
删除Session用户退出系统,即是清除掉当前登陆状态。在本实战项目中,我们直接通过清除Session中的管理员信息即可实现对登陆状态的清除。
ac.Session.Delete(ADMIN);