go语言框架gin之集成swagger

1.先安装Go对应的开源Swagger相关的库

让客户满意是我们工作的目标，不断超越客户的期望值来自于我们对这个行业的热爱。我们立志把好的技术通过有效、简单的方式提供给客户，将通过不懈努力成为客户在信息化领域值得信任、有价值的长期合作伙伴，公司提供的服务项目有：空间域名、网站空间、营销软件、网站建设、华坪网站维护、网站推广。

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 标签

// @Produce  json

// @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 标签

// @Produce  json

// @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 标签

// @Produce  json

// @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,完成

微服务框架全家福都有哪些

度娘给出的一个完整答案，总结的很全面

Java系微服务框架

· Spring Boot/ Netflix OSS/Spring Cloud

· Dubbo

· Dropwizard

· Akka

· Vert.x/ Lagom/ ReactiveX/Spring 5

· 除了以上介绍的这些主流微服务框架外，还有Grizzly、KumuluzEE、ConductR、Ninja、Jodd、Restlet、RESTEasy、Payara Micro、Redkale、RestExpress、restx、JessMA、eventuate、Rapidoid、Ratpack、Javalite、JHipster及Bootique.io等

.Net系微服务框架

· Service Fabric

· Surging

· Steeltoe OSS

· Microdot Framework

· .NET China Foundation

· 除以上框架，还有Xigadee、Apworks framework、Cronus、NancyFx、GRPC等相关框架和项目

Node.js微服务框架

· Seneca

· Hapi/ restify/ LoopBack

Go微服务框架

· Go-Kit

· Goa

· Dubbogo

· 除了上面3种基于Go语言的微服务框架，还有Micro、Gizmo等

Python微服务框架

· Nameko， Python的微服务框架非常少，暂时就列出一个框架

go有没有开源的类似java的mina或者netty的socket框架

mina与netty都是Trustin Lee的作品，所以在很多方面都十分相似，他们线程模型也是基本一致，采用了Reactors in threads模型，即Main Reactor + Sub Reactors的模式。由main reactor处理连接相关的任务：accept、connect等，当连接处理完毕并建立

国内用Go语言开发的成熟项目有哪些

国外很有多优秀的HTML5前端开发框架比如：JQueryMobile，TwitterBootstrap，Schena Touch, BackBone等等。

同样，也存在很多国内比较优秀的前端开发框架，其中中国互联网三巨头贡献了近一半：腾讯，阿里巴巴，百度。

框架不是万能的，选择和项目匹配的框架可以显著提高开发效率，但是也有可能带来代码的臃肿，选择合适的框架是最重要的。其中每个框架各有特点，还需要你自己把关。如：腾讯的JX比较适合构建和组织大规模、工业级的WebApp，腾讯内部的WebQQ、Q+等产品都是采用JX框架开发。

这里整理了一下文档，以附件形式分享给你吧~请收下~

Go语言的开源项目

1．Docker项目

网址为 。

介绍：Docker是一种操作系统层面的虚拟化技术，可以在操作系统和应用程序之间进行隔离，也可以称之为容器。Docker可以在一台物理服务器上快速运行一个或多个实例。例如，启动一个Cent OS操作系统，并在其内部命令行执行指令后结束，整个过程就像自己在操作系统一样高效。

2．golang项目

网址为 。

介绍：Go语言的早期源码使用C语言和汇编语言写成。从Go 1.5版本自举后，完全使用Go语言自身进行编写。Go语言的源码对了解Go语言的底层调度有极大的参考意义，建议希望对Go语言有深入了解的读者读一读。

3．Kubernetes项目

网址为 。

介绍：Google公司开发的构建于Docker之上的容器调度服务，用户可以通过Kubernetes集群进行云端容器集群管理。

4．etcd项目

网址为 。

介绍：一款分布式、可靠的KV存储系统，可以快速进行云配置。

5．beego项目

网址为 。

介绍：beego是一个类似Python的Tornado框架，采用了RESTFul的设计思路，使用Go语言编写的一个极轻量级、高可伸缩性和高性能的Web应用框架。

6．martini项目

网址为 。

介绍：一款快速构建模块化的Web应用的Web框架。

7．codis项目

网址为 Labs/codis。

介绍：国产的优秀分布式Redis解决方案。

8．delve项目

网址为 。

介绍：Go语言强大的调试器，被很多集成环境和编辑器整合。

有没有人用golang实现过restful框架的实例

通过beego快速创建一个Restful风格API项目及API文档自动化:

Go 语言构建 RESTful Web 服务:

Golang中使用 JWT认证来 保障Restful JSON API的安全（英文）:

polaris: 一个用go实现的支持restful的web框架:

关于RESTFUL API 安全认证方式的一些总结:

有没有人用golang实现过restful框架的实例:

Micro 一个用Go语言实现的微服务框架:

基于微服务库的可插拔RPC go-micro:

golang适合做web开发吗？:

a-survey-of-5-go-web-frameworks:

Ozzo Framework:

avelino/awesome-go:

Beego Framework:

golang其实不适合做web开发:

Go语言现有Web开发框架:

使用Golang快速构建WEB应用:

Martini 极好的 Go WEB 框架:

golang 有哪些比较稳定的 web 开发框架？:

网页名称：go语言流行的框架 go常用的框架
转载注明：http://kswjz.com/article/hheggh.html