1.先安裝Go對(duì)應(yīng)的開源Swagger相關(guān)的庫(kù)
讓客戶滿意是我們工作的目標(biāo)，不斷超越客戶的期望值來自于我們對(duì)這個(gè)行業(yè)的熱愛。我們立志把好的技術(shù)通過有效、簡(jiǎn)單的方式提供給客戶，將通過不懈努力成為客戶在信息化領(lǐng)域值得信任、有價(jià)值的長(zhǎng)期合作伙伴，公司提供的服務(wù)項(xiàng)目有：空間域名、網(wǎng)站空間、營(yíng)銷軟件、網(wǎng)站建設(shè)、華坪網(wǎng)站維護(hù)、網(wǎng)站推廣。
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.驗(yàn)證是否安裝成功：swag -v
3.針對(duì)接口寫入注解
// @Summary 獲取多個(gè)標(biāo)簽
// @Tags 標(biāo)簽
// @Produce? json
// @Param name query string false "標(biāo)簽名稱" maxlength(100)
// @Param state query int false "狀態(tài)" Enums(0, 1) default(1)
// @Param page query int false "頁(yè)碼"
// @Param page_size query int false "每頁(yè)數(shù)量"
// @Success 200 {object} model.TagSwagger "成功"
// @Failure 400 {object} errcode.Error "請(qǐng)求錯(cuò)誤"
// @Failure 500 {object} errcode.Error "內(nèi)部錯(cuò)誤"
// @Router /api/v1/tags [get]
func (t Tag) List(c *gin.Context) {
}
// @Summary 新增標(biāo)簽
// @Tags 標(biāo)簽
// @Produce? json
// @Param name body string true "標(biāo)簽名稱" minlength(3) maxlength(100)
// @Param state body int false "狀態(tài)" Enums(0, 1) default(1)
// @Param created_by body string false "創(chuàng)建者" minlength(3) maxlength(100)
// @Success 200 {object} model.Tag "成功"
// @Failure 400 {object} errcode.Error "請(qǐng)求錯(cuò)誤"
// @Failure 500 {object} errcode.Error "內(nèi)部錯(cuò)誤"
// @Router /api/v1/tags [post]
func (t Tag) Create(c *gin.Context) {
}
// @Summary 更新標(biāo)簽
// @Tags 標(biāo)簽
// @Produce? json
// @Param id path int true "標(biāo)簽ID"
// @Param name body string false "標(biāo)簽名稱" minlength(3) maxlength(100)
// @Param state body int false "狀態(tài) (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 "請(qǐng)求錯(cuò)誤"
// @Failure 500 {object} errcode.Error "內(nèi)部錯(cuò)誤"
// @Router /api/v1/tags/{id} [put]
func (t Tag) Update(c *gin.Context) {
}
4.針對(duì)整個(gè)項(xiàng)目進(jìn)行注解，直接在main方法寫入如下注解
//@title 項(xiàng)目名稱
//@version 1.0
//@description 這里是描述
func main() {
5.生成執(zhí)行 swag init
這時(shí)會(huì)在我項(xiàng)目的docs文件夾下面生成docs.go、swagger.json、swagger.yaml三個(gè)文件
6.要在routers中進(jìn)行默認(rèn)初始化和注冊(cè)對(duì)應(yīng)的路由：
r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
同時(shí)要引用 _"blog-service/docs" ，不然會(huì)報(bào)錯(cuò)
7.查看接口文檔 ：
8.ok,完成
度娘給出的一個(gè)完整答案，總結(jié)的很全面
Java系微服務(wù)框架
· Spring Boot/ Netflix OSS/Spring Cloud
· Dubbo
· Dropwizard
· Akka
· Vert.x/ Lagom/ ReactiveX/Spring 5
· 除了以上介紹的這些主流微服務(wù)框架外，還有Grizzly、KumuluzEE、ConductR、Ninja、Jodd、Restlet、RESTEasy、Payara Micro、Redkale、RestExpress、restx、JessMA、eventuate、Rapidoid、Ratpack、Javalite、JHipster及Bootique.io等
.Net系微服務(wù)框架
· Service Fabric
· Surging
· Steeltoe OSS
· Microdot Framework
· .NET China Foundation
· 除以上框架，還有Xigadee、Apworks framework、Cronus、NancyFx、GRPC等相關(guān)框架和項(xiàng)目
Node.js微服務(wù)框架
· Seneca
· Hapi/ restify/ LoopBack
Go微服務(wù)框架
· Go-Kit
· Goa
· Dubbogo
· 除了上面3種基于Go語(yǔ)言的微服務(wù)框架，還有Micro、Gizmo等
Python微服務(wù)框架
· Nameko， Python的微服務(wù)框架非常少，暫時(shí)就列出一個(gè)框架
mina與netty都是Trustin Lee的作品，所以在很多方面都十分相似，他們線程模型也是基本一致，采用了Reactors in threads模型，即Main Reactor + Sub Reactors的模式。由main reactor處理連接相關(guān)的任務(wù)：accept、connect等，當(dāng)連接處理完畢并建立
國(guó)外很有多優(yōu)秀的HTML5前端開發(fā)框架比如：JQueryMobile，TwitterBootstrap，Schena Touch, BackBone等等。
同樣，也存在很多國(guó)內(nèi)比較優(yōu)秀的前端開發(fā)框架，其中中國(guó)互聯(lián)網(wǎng)三巨頭貢獻(xiàn)了近一半：騰訊，阿里巴巴，百度。
框架不是萬(wàn)能的，選擇和項(xiàng)目匹配的框架可以顯著提高開發(fā)效率，但是也有可能帶來代碼的臃腫，選擇合適的框架是最重要的。其中每個(gè)框架各有特點(diǎn)，還需要你自己把關(guān)。如：騰訊的JX比較適合構(gòu)建和組織大規(guī)模、工業(yè)級(jí)的WebApp，騰訊內(nèi)部的WebQQ、Q+等產(chǎn)品都是采用JX框架開發(fā)。
這里整理了一下文檔，以附件形式分享給你吧~請(qǐng)收下~
1．Docker項(xiàng)目
網(wǎng)址為 。
介紹：Docker是一種操作系統(tǒng)層面的虛擬化技術(shù)，可以在操作系統(tǒng)和應(yīng)用程序之間進(jìn)行隔離，也可以稱之為容器。Docker可以在一臺(tái)物理服務(wù)器上快速運(yùn)行一個(gè)或多個(gè)實(shí)例。例如，啟動(dòng)一個(gè)Cent OS操作系統(tǒng)，并在其內(nèi)部命令行執(zhí)行指令后結(jié)束，整個(gè)過程就像自己在操作系統(tǒng)一樣高效。
2．golang項(xiàng)目
網(wǎng)址為 。
介紹：Go語(yǔ)言的早期源碼使用C語(yǔ)言和匯編語(yǔ)言寫成。從Go 1.5版本自舉后，完全使用Go語(yǔ)言自身進(jìn)行編寫。Go語(yǔ)言的源碼對(duì)了解Go語(yǔ)言的底層調(diào)度有極大的參考意義，建議希望對(duì)Go語(yǔ)言有深入了解的讀者讀一讀。
3．Kubernetes項(xiàng)目
網(wǎng)址為 。
介紹：Google公司開發(fā)的構(gòu)建于Docker之上的容器調(diào)度服務(wù)，用戶可以通過Kubernetes集群進(jìn)行云端容器集群管理。
4．etcd項(xiàng)目
網(wǎng)址為 。
介紹：一款分布式、可靠的KV存儲(chǔ)系統(tǒng)，可以快速進(jìn)行云配置。
5．beego項(xiàng)目
網(wǎng)址為 。
介紹：beego是一個(gè)類似Python的Tornado框架，采用了RESTFul的設(shè)計(jì)思路，使用Go語(yǔ)言編寫的一個(gè)極輕量級(jí)、高可伸縮性和高性能的Web應(yīng)用框架。
6．martini項(xiàng)目
網(wǎng)址為 。
介紹：一款快速構(gòu)建模塊化的Web應(yīng)用的Web框架。
7．codis項(xiàng)目
網(wǎng)址為 Labs/codis。
介紹：國(guó)產(chǎn)的優(yōu)秀分布式Redis解決方案。
8．delve項(xiàng)目
網(wǎng)址為 。
介紹：Go語(yǔ)言強(qiáng)大的調(diào)試器，被很多集成環(huán)境和編輯器整合。
通過beego快速創(chuàng)建一個(gè)Restful風(fēng)格API項(xiàng)目及API文檔自動(dòng)化:
Go 語(yǔ)言構(gòu)建 RESTful Web 服務(wù):
Golang中使用 JWT認(rèn)證來 保障Restful JSON API的安全（英文）:
polaris: 一個(gè)用go實(shí)現(xiàn)的支持restful的web框架:
關(guān)于RESTFUL API 安全認(rèn)證方式的一些總結(jié):
有沒有人用golang實(shí)現(xiàn)過restful框架的實(shí)例:
Micro 一個(gè)用Go語(yǔ)言實(shí)現(xiàn)的微服務(wù)框架:
基于微服務(wù)庫(kù)的可插拔RPC go-micro:
golang適合做web開發(fā)嗎？:
a-survey-of-5-go-web-frameworks:
Ozzo Framework:
avelino/awesome-go:
Beego Framework:
golang其實(shí)不適合做web開發(fā):
Go語(yǔ)言現(xiàn)有Web開發(fā)框架:
使用Golang快速構(gòu)建WEB應(yīng)用:
Martini 極好的 Go WEB 框架:
golang 有哪些比較穩(wěn)定的 web 開發(fā)框架？:
重慶分公司
重慶分公司
