go语言框架gin之集成swagger1.先安装Go对应的开源Swagger相关的库
【go经典语言框架 go语言gin框架】 go get github.com/swaggo/swag/cmd/swag
go get github.com/swaggo/gin-swagger
go get github.com/swaggo/files
go get github.com/alecthomas/template
2.验证是否安装成功:swag -v
3.针对接口写入注解
// @Summary 获取多个标签
// @Tags 标签
// @Producejson
// @Param name query string false "标签名称" maxlength(100)
// @Param state query int false "状态" Enums(0, 1) default(1)
// @Param page query int false "页码"
// @Param page_size query int false "每页数量"
// @Success 200 {object} model.TagSwagger "成功"
// @Failure 400 {object} errcode.Error "请求错误"
// @Failure 500 {object} errcode.Error "内部错误"
// @Router /api/v1/tags [get]
func (t Tag) List(c *gin.Context) {
}
// @Summary 新增标签
// @Tags 标签
// @Producejson
// @Param name body string true "标签名称" minlength(3) maxlength(100)
// @Param state body int false "状态" Enums(0, 1) default(1)
// @Param created_by body string false "创建者" minlength(3) maxlength(100)
// @Success 200 {object} model.Tag "成功"
// @Failure 400 {object} errcode.Error "请求错误"
// @Failure 500 {object} errcode.Error "内部错误"
// @Router /api/v1/tags [post]
func (t Tag) Create(c *gin.Context) {
}
// @Summary 更新标签
// @Tags 标签
// @Producejson
// @Param id path int true "标签ID"
// @Param name body string false "标签名称" minlength(3) maxlength(100)
// @Param state body int false "状态 (0为未删除、1为已删除)" Enums(0, 1) default(1)
// @Param modified_by body string true "修改者" minlength(3) maxlength(100)
// @Success 200 {array} model.Tag "成功"
// @Failure 400 {object} errcode.Error "请求错误"
// @Failure 500 {object} errcode.Error "内部错误"
// @Router /api/v1/tags/{id} [put]
func (t Tag) Update(c *gin.Context) {
}
4.针对整个项目进行注解,直接在main方法写入如下注解
//@title 项目名称
//@version 1.0
//@description 这里是描述
func main() {
5.生成执行 swag init
这时会在我项目的docs文件夹下面生成docs.go、swagger.json、swagger.yaml三个文件
6.要在routers中进行默认初始化和注册对应的路由:
r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
同时要引用 _"blog-service/docs",不然会报错
7.查看接口文档 :
8.ok,完成
go语言有没有类似tp5框架有,go语言有框架,例如:Beego(Go语言下开源的,高性能Web框架 )、Buffalo(Go语言下快速Web开发框架)、Echo、Gin、Iris、Revel(高生产率 , 全栈Go语言的Web框架)等 。
Go微服务--常见的微服务框架近几年诞生了很多微服务框架,比如JAVA的Spring Cloud、Dubbo;Golang的GoKit和GoMicro以及NodeJs的Seneca 。几乎每种主流语言都有其对应的微服务框架 。
Go在微服务框架中有其独特的优势,至于优势在哪,自行google 。
1、GoKit框架
这是一个工具包的集合,可以帮助攻城狮构建强大、可靠和可维护的微服务 。提供了用于实现系统监控和弹性模式组件的库,例如日志、跟踪、限流、熔断等 。
基于这个框架的应用程序架构由三个主要的部分组成:
传输层:用于网络通信 , 服务通常使用HTTP或者gRPC等网络传输协议,或者使用NATS等发布订阅系统相互通信 。
接口层:是服务器和客户端的基本构建块 。每个对外提供的接口方法都会定义为一个Endpoint , 一遍在服务器和客户端之间进行网络通信,每个端点使用传输层通过HTTP或gRPC等具体通信模式对外提供服务
推荐阅读
- ios系统高清壁纸手机壁纸下载,ios高清壁纸4k
- 路由器信号源代表什么数字,路由器信号原理图
- 愤怒小鸟的赛车游戏下载,愤怒的小鸟创造赛车
- 直播伴侣新增付费直播,直播伴侣新增付费直播怎么设置
- c语言矩阵变倍函数 c语言矩阵变换
- 主变压器gis组合电器,主变压器组成
- 改ip代理软件哪个好,换ip的代理软件哪个好
- 体育趣味扑克牌游戏教案,体育趣味扑克牌游戏教案中班
- python的函数案例 python函数编程200例