「这是我参与2022首次更文挑战的第26天,活动详情查看:2022首次更文挑战」
生命不息,学习不止
题外话
今天是周三啦,我最近好像生病了,生了一种一上班就没精神的病,医生说我这种病只有一种药能治,叫暴富,大家知道哪里能找到嘛,请大家开动小脑筋好好想一想,就拜托大家啦!!!
废话不多说,上货
开源项目——go-gin-api
go-gin-api
这是一个主要以gin框架为主,包含了一些常用功能,包括日志,菜单,权限,代码生成的功能的一个项目。
需求回顾
上回咱们完成了这个项目的第一个小需求:仪表盘的内存信息板中的总量数值在获取计算机内存数值基础上+1
并根据前端框架请求的dashboard接口找到了dashboard.go文件,修改了obj.MemTotal的值完成需求。
顺便解析dashboard.go文件,讲解了具体逻辑和相关引用的包。
今天的目标就是再搞一个小需求,奥里给
调整数据展示顺序
我们可以看到管理员这个列表中数据的展示是降序的,我觉得不好,所以这次的小需求就是调整管理员列表数据的展示顺序,调整为升序排序。
需求定位
我们要先知道管理员列表这个页面请求的接口,这回不再是后端直接返回的页面模板了,而是给了具体参数,我们才有右键,点击检查,点击下图方框中Fetch/XHR,再重新点击项目页面中管理员菜单即可看到如下页面
可以看到标头下常规中的请求网址就包含了该页面的请求接口
http://127.0.0.1:9999/api/admin?page=1&page_size=10
并且可以看到是一个get请求,?号后面拼接的便是请求的参数
但其实这个请求不是完整的,当我们再次查看框架源代码时就可以发现,请求的再次添加了list,这个list对应的是方法
根据该请求我们就能找到对应的go文件internal\api\admin\func_list.go
在func_list.go文件中,我们能看到List()方法
通过注解我们可以很清晰的明白该接口的作用,所需参数,返回值,成功与失败的状态码等等
// @Produce json
这个注解大家不要漏掉了,这个注解标明了传递进来的参数是什么格式,如这个注解所以,list接受的参数是以json的方式传递的。
@Param是方法的参数
// @Success 200 {object} listResponse //成功返回值
// @Failure 400 {object} code.Failure //失败返回值
下回预告
下回咱们就再来实现这个需求。
下一篇就讲,敬请期待
大家看完发现有什么错误,写在下面吧!跟我黑虎阿福比划比划!