go語言框架gin之集成swagger

1.先安裝Go對應(yīng)的開源Swagger相關(guān)的庫

“只有客戶發(fā)展了，才有我們的生存與發(fā)展！”這是成都創(chuàng)新互聯(lián)的服務(wù)宗旨！把網(wǎng)站當作互聯(lián)網(wǎng)產(chǎn)品，產(chǎn)品思維更注重全局思維、需求分析和迭代思維，在網(wǎng)站建設(shè)中就是為了建設(shè)一個不僅審美在線，而且實用性極高的網(wǎng)站。創(chuàng)新互聯(lián)對成都網(wǎng)站建設(shè)、做網(wǎng)站、網(wǎng)站制作、網(wǎng)站開發(fā)、網(wǎng)頁設(shè)計、網(wǎng)站優(yōu)化、網(wǎng)絡(luò)推廣、探索永無止境。

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 "狀態(tài)" Enums(0, 1) default(1)

// @Param page query int false "頁碼"

// @Param page_size query int false "每頁數(shù)量"

// @Success 200 {object} model.TagSwagger "成功"

// @Failure 400 {object} errcode.Error "請求錯誤"

// @Failure 500 {object} errcode.Error "內(nèi)部錯誤"

// @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 "狀態(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 "請求錯誤"

// @Failure 500 {object} errcode.Error "內(nèi)部錯誤"

// @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 "狀態(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 "請求錯誤"

// @Failure 500 {object} errcode.Error "內(nèi)部錯誤"

// @Router /api/v1/tags/{id} [put]

func (t Tag) Update(c *gin.Context) {

}

4.針對整個項目進行注解，直接在main方法寫入如下注解

//@title 項目名稱

//@version 1.0

//@description 這里是描述

func main() {

5.生成執(zhí)行 swag init

這時會在我項目的docs文件夾下面生成docs.go、swagger.json、swagger.yaml三個文件

6.要在routers中進行默認初始化和注冊對應(yīng)的路由：

r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))

同時要引用 _"blog-service/docs" ，不然會報錯

7.查看接口文檔 ：

8.ok,完成

Go語言設(shè)計與實現(xiàn)（上）

基本設(shè)計思路：

類型轉(zhuǎn)換、類型斷言、動態(tài)派發(fā)。iface，eface。

反射對象具有的方法：

編譯優(yōu)化：

內(nèi)部實現(xiàn)：

實現(xiàn) Context 接口有以下幾個類型（空實現(xiàn)就忽略了）：

互斥鎖的控制邏輯：

設(shè)計思路：

（以上為寫被讀阻塞，下面是讀被寫阻塞）

總結(jié)，讀寫鎖的設(shè)計還是非常巧妙的：

設(shè)計思路：

WaitGroup 有三個暴露的函數(shù):

部件：

設(shè)計思路：

結(jié)構(gòu)：

Once 只暴露了一個方法：

實現(xiàn)：

三個關(guān)鍵點：

細節(jié)：

讓多協(xié)程任務(wù)的開始執(zhí)行時間可控（按順序或歸一）。（Context 是控制結(jié)束時間）

設(shè)計思路： 通過一個鎖和內(nèi)置的 notifyList 隊列實現(xiàn)，Wait() 會生成票據(jù)，并將等待協(xié)程信息加入鏈表中，等待控制協(xié)程中發(fā)送信號通知一個（Signal()）或所有（Boardcast()）等待者（內(nèi)部實現(xiàn)是通過票據(jù)通知的）來控制協(xié)程解除阻塞。

暴露四個函數(shù)：

實現(xiàn)細節(jié)：

部件：

包： golang.org/x/sync/errgroup

作用：開啟 func() error 函數(shù)簽名的協(xié)程，在同 Group 下協(xié)程并發(fā)執(zhí)行過程并收集首次 err 錯誤。通過 Context 的傳入，還可以控制在首次 err 出現(xiàn)時就終止組內(nèi)各協(xié)程。

設(shè)計思路：

結(jié)構(gòu)：

暴露的方法：

實現(xiàn)細節(jié)：

注意問題：

包： "golang.org/x/sync/semaphore"

作用：排隊借資源（如錢，有借有還）的一種場景。此包相當于對底層信號量的一種暴露。

設(shè)計思路：有一定數(shù)量的資源 Weight，每一個 waiter 攜帶一個 channel 和要借的數(shù)量 n。通過隊列排隊執(zhí)行借貸。

結(jié)構(gòu)：

暴露方法：

細節(jié)：

部件：

細節(jié)：

包： "golang.org/x/sync/singleflight"

作用：防擊穿。瞬時的相同請求只調(diào)用一次，response 被所有相同請求共享。

設(shè)計思路：按請求的 key 分組（一個 *call 是一個組，用 map 映射存儲組），每個組只進行一次訪問，組內(nèi)每個協(xié)程會獲得對應(yīng)結(jié)果的一個拷貝。

結(jié)構(gòu)：

邏輯：

細節(jié)：

部件：

如有錯誤，請批評指正。

go語言 ioutil.ReadFile 與ioutil.ReadAll差別

?? 當讀取91.2 MB文件時，read1耗時43ms，read2耗時99ms。

查看源碼：

讀取文件主要是通過 Read(p []byte) (n int, err error) ：

官方文檔中關(guān)于該接口方法的說明：

結(jié)論：

??ReadFile(filename string)方法之所以速度快的原因就是先計算出file文件的size，在初始化對應(yīng)size大小的buff，傳入ReadRead(p []byte) 來讀取字節(jié)流

Go語言的支持平臺

LiteIDE是一款專門為Go語言開發(fā)的跨平臺輕量級集成開發(fā)環(huán)境（IDE），由QT編寫。

LiteIDE主要特點： 支持主流操作系統(tǒng)

Windows

Linux

MacOS X Go編譯環(huán)境管理和切換

管理和切換多個Go編譯環(huán)境

支持Go語言交叉編譯 與Go標準一致的項目管理方式

基于GOPATH的包瀏覽器

基于GOPATH的編譯系統(tǒng)

基于GOPATH的Api文檔檢索 Go語言的編輯支持

類瀏覽器和大綱顯示

Gocode(代碼自動完成工具)的完美支持

Go語言文檔查看和Api快速檢索

代碼表達式信息顯示F1

源代碼定義跳轉(zhuǎn)支持F2

Gdb斷點和調(diào)試支持

gofmt自動格式化支持 其他特征

支持多國語言界面顯示

完全插件體系結(jié)構(gòu)

支持編輯器配色方案

基于Kate的語法顯示支持

基于全文的單詞自動完成

支持鍵盤快捷鍵綁定方案

Markdown文檔編輯支持

實時預(yù)覽和同步顯示

自定義CSS顯示

可導(dǎo)出HTML和PDF文檔

批量轉(zhuǎn)換/合并為HTML/PDF文檔 Sublime Text 2（以下簡稱Sublime）+ GoSublime + gocode + MarGo的組合。

其優(yōu)點有： 自動化提示代碼。 保存的時候自動格式化代碼，讓您編寫的代碼更加美觀，符合Go的標準。 支持項目管理 支持語法高亮 熟悉Java的讀者應(yīng)該對于idea不陌生，idea是通過一個插件來支持go語言的高亮語法，代碼提示和重構(gòu)實現(xiàn)。

分享題目：go語言的接口文檔查詢,go api文檔生成
分享網(wǎng)址：http://chinadenli.net/article0/dsgseoo.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供關(guān)鍵詞優(yōu)化、靜態(tài)網(wǎng)站、虛擬主機、網(wǎng)頁設(shè)計公司、面包屑導(dǎo)航、小程序開發(fā)

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)