uniapp开发app框架在提升开发效率中的独特优势与应用探索
1224
2022-11-25
简述Gin框架集成swagger过程
简述Gin框架集成swagger过程
1、安装 swag
go get github.com/swaggo/swag/cmd/swag
swag 用于生成 docs 文件夹(swagger文档程序使用)
安装完成后会在 ${GOPATH}/bin生成一个执行文件
2、安装依赖包
github.com/gin-gonic/gingithub.com/swaggo/gin-swagger
3、示例程序
package mainimport ( _ "./docs" "github.com/gin-gonic/gin" "github.com/swaggo/gin-swagger" "github.com/swaggo/gin-swagger/swaggerFiles" "net/@title 测试// @version 0.0.1// @description 测试// @BasePath /api/v1/func main() { r := gin.New() // 创建路由组 v1 := r.Group("/api/v1") v1.GET("/record/:userId",record) // 文档界面访问URL // r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler)) r.Run()}// Name will print hello name// @Summary Print// @Accept json// @Tags Name12// @Security Bearer// @Produce json// @Param some_id path int true "userId"// @Resource Name// @Router /record/{some_id} [get]// @Success 200 {string} string "ok"func record(c *gin.Context) { c.String("ok")}
注意:main 方法上的 @BasePath /api/v1/ 和 record 方法 上的@Router /record/{some_id} [get] 并不是像 beego 注解一样用来当方法路由用的,而是swagger 不能识别具体的哪个路由对应哪个方法,所以需要手动指定,供界面的 Try it out 使用
其他参数:参考文档
4、生成文档
在项目执行 swag init
执行 go run main.go
进入 查看文档
目录下 执行命令
swag init
自动生成 docs 文件夹,内含 swagger.json 、swagger.json 、 docs.go 编译不通过,查看报错信息,修改注释。
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~