跟着开源项目学GO(11)

325 阅读3分钟

「这是我参与2022首次更文挑战的第26天,活动详情查看:2022首次更文挑战

生命不息,学习不止

题外话

今天是周三啦,我最近好像生病了,生了一种一上班就没精神的病,医生说我这种病只有一种药能治,叫暴富,大家知道哪里能找到嘛,请大家开动小脑筋好好想一想,就拜托大家啦!!!

截图_20222517032552.png

废话不多说,上货

在这里插入图片描述

开源项目——go-gin-api

go-gin-api

这是一个主要以gin框架为主,包含了一些常用功能,包括日志,菜单,权限,代码生成的功能的一个项目。

需求回顾

上回咱们完成了这个项目的第一个小需求:仪表盘的内存信息板中的总量数值在获取计算机内存数值基础上+1

并根据前端框架请求的dashboard接口找到了dashboard.go文件,修改了obj.MemTotal的值完成需求。

顺便解析dashboard.go文件,讲解了具体逻辑和相关引用的包。

今天的目标就是再搞一个小需求,奥里给

调整数据展示顺序

截图_20222222112226.png

我们可以看到管理员这个列表中数据的展示是降序的,我觉得不好,所以这次的小需求就是调整管理员列表数据的展示顺序,调整为升序排序。

需求定位

我们要先知道管理员列表这个页面请求的接口,这回不再是后端直接返回的页面模板了,而是给了具体参数,我们才有右键,点击检查,点击下图方框中Fetch/XHR,再重新点击项目页面中管理员菜单即可看到如下页面

截图_20220623030641.png

可以看到标头下常规中的请求网址就包含了该页面的请求接口

http://127.0.0.1:9999/api/admin?page=1&page_size=10

并且可以看到是一个get请求,?号后面拼接的便是请求的参数

但其实这个请求不是完整的,当我们再次查看框架源代码时就可以发现,请求的再次添加了list,这个list对应的是方法

截图_20224423064408.png

根据该请求我们就能找到对应的go文件internal\api\admin\func_list.go

在func_list.go文件中,我们能看到List()方法

截图_20224623064656.png

通过注解我们可以很清晰的明白该接口的作用,所需参数,返回值,成功与失败的状态码等等

// @Produce json

这个注解大家不要漏掉了,这个注解标明了传递进来的参数是什么格式,如这个注解所以,list接受的参数是以json的方式传递的。

@Param是方法的参数

// @Success 200 {object} listResponse  //成功返回值
// @Failure 400 {object} code.Failure  //失败返回值

下回预告

下回咱们就再来实现这个需求。

下一篇就讲,敬请期待

在这里插入图片描述

大家看完发现有什么错误,写在下面吧!跟我黑虎阿福比划比划! 在这里插入图片描述