gin-swagger

1. 下載 swagger
2. 加載 swagger
3. 執(zhí)行 swagger命令
4. 使用Cors中間件
5. 測試

1 下載swagger

go get -u github.com/swaggo/swag/cmd/swag

2 安裝swagger

安裝go-swagger杆逗，移動到下載的go-swagger包目錄（應(yīng)該是GOPATH/src/pkg/github.com/go-swagger,理解這個意思就好，路徑不一定對）。

go install ./cmd/swagger

測試是否安裝成功 cmd 執(zhí)行 swag -V 反饋 swag 版本

執(zhí)行后菊碟，會生成docs/doc.go以及docs/swagger.json,docs/swagger.yaml

go get -u github.com/swaggo/gin-swagger
go get -u github.com/swaggo/files

2 加載 swagger

package router

import (
    "gin_t/middelwares"
    "gin_t/service"
    "net/http"

    "github.com/gin-gonic/gin"
    swaggerfiles "github.com/swaggo/files"
    ginSwagger "github.com/swaggo/gin-swagger"
)

// @Tags 標(biāo)簽
// @Summary 標(biāo)題
// @description 描述,可以有多個

// @Success 200 {string} json "{"code":"200","data":"message":"string"}"
// @Router /ping [get]
func Router() *gin.Engine {
    r := gin.Default()
    r.Use(middelwares.Cors())
    r.GET("/ping", func(ctx *gin.Context) {
        ctx.JSON(http.StatusOK, gin.H{
            "message": "pong",
        })
    })
    // Swagger 配置
    r.GET("swagger/*any", ginSwagger.WrapHandler(swaggerfiles.Handler))
    return r
}

package service

import (
    "net/http"

    "github.com/gin-gonic/gin"
)

func Ping(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
        "message": "pong",
    })
}

package main

import (
    _ "gin_t/docs"
    "gin_t/router"
)

// @title API文檔
// @version 1.0
// @description API 文檔
// @host 127.0.0.01:8080
// @BasePath

func main() {
    
    r := router.Router()

    r.Run()
}

3 執(zhí)行 swagger命令

cmd 項目執(zhí)行  swag init  

4 使用Cors中間件

package middelwares

import (
    "fmt"
    "strings"

    "github.com/gin-gonic/gin"
)

func Cors() gin.HandlerFunc {
    return func(c *gin.Context) {
        method := c.Request.Method
        origin := c.Request.Header.Get("Origin")
        var headerKeys []string
        for k, _ := range c.Request.Header {
            headerKeys = append(headerKeys, k)
        }
        headerStr := strings.Join(headerKeys, ", ")
        if headerStr != "" {
            headerStr = fmt.Sprintf("access-control-allow-origin, access-control-allow-headers, %s", headerStr)
        } else {
            headerStr = "access-control-allow-origin, access-control-allow-headers"
        }
        if origin != "" {
            c.Writer.Header().Set("Access-Control-Allow-Origin", "*")
            c.Header("Access-Control-Allow-Origin", "*")                                       // 這是允許訪問所有域
            c.Header("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE,UPDATE") //服務(wù)器支持的所有跨域請求的方法,為了避免瀏覽次請求的多次'預(yù)檢'請求
            //  header的類型
            c.Header("Access-Control-Allow-Headers", "Authorization, Content-Length, X-CSRF-Token, Token,session,X_Requested_With,Accept, Origin, Host, Connection, Accept-Encoding, Accept-Language,DNT, X-CustomHeader, Keep-Alive, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, Pragma")
            //              允許跨域設(shè)置                                                                                                      可以返回其他子段
            c.Header("Access-Control-Expose-Headers", "Content-Length, Access-Control-Allow-Origin, Access-Control-Allow-Headers,Cache-Control,Content-Language,Content-Type,Expires,Last-Modified,Pragma,FooBar") // 跨域關(guān)鍵設(shè)置 讓瀏覽器可以解析
            c.Header("Access-Control-Max-Age", "172800")                                                                                                                                                           // 緩存請求信息 單位為秒
            c.Header("Access-Control-Allow-Credentials", "false")                                                                                                                                                  //  跨域請求是否需要帶cookie信息 默認設(shè)置為true
            c.Set("content-type", "application/json")                                                                                                                                                              // 設(shè)置返回格式是json
        }

        //放行所有OPTIONS方法
        //if method == "OPTIONS" {
        //    c.JSON(http.StatusOK, "Options Request!")
        //}
        if method == "OPTIONS" {
            c.AbortWithStatus(204)
            return
        }
        // 處理請求
        c.Next() //  處理請求
    }
}

5 測試

http://localhost:8080/swagger/index.html

swag注解開發(fā)方法

swagger主文件注解-通用API信息

每個API的注釋編寫-單個api

//各個api.go
// GetProblemList
// @Tags 公共方法
// @Summary 問題列表
// @Param page query int false "page"
// @Param size query int false "size"
// @Param keyword query string false "keyword"
// @Param category_identity query string false "category_identity"
// @Success 200 {string} json "{"code":"200","data":""}"
// @Router /problem-list [get]

//各個api.go
// @Summary 支付列表
// @Description 獲取支付列表
// @Accept  json
// @Produce  json
// @param Authorization header string true "驗證參數(shù)Bearer和token空格拼接"
// @Param  body body st.PaySearch true "交款查詢參數(shù)"
// @Success 200 {object} response.Response{data=st.PayListResponse}
// @Failure 500 {object} response.Response
// @Router /app/pay/list [post]


//main.go
// @title 這里寫標(biāo)題`
// @version 1.0`
// @description 這里寫描述信息`
// @termsOfService [http://swagger.io/terms/](http://swagger.io/terms/)`
// @contact.name 這里寫聯(lián)系人信息`
// @contact.url [http://www.swagger.io/support](http://www.swagger.io/support)`
// @contact.email support@swagger.io`
// @license.name Apache 2.0`
// @license.url [http://www.apache.org/licenses/LICENSE-2.0.html](http://www.apache.org/licenses/LICENSE-2.0.html)`
// @host 這里寫接口服務(wù)的host`
// @BasePath 這里寫base path`


//main.go
// @title API文檔
// @version 1.0
// @description API 文檔
// @host 127.0.0.01:8080
// @BasePath