go语言框架gin之集成swagger

1、安装swag

在goland中直接使用go get -u github.com/swaggo/swag/cmd/swag命令安装会报错

翻了很多博客，都没找到太合适的办法，根据博客中所写的操作还是会报错，最后用git直接下载也挺方便的，类似这种问题都可以使用此方法

 此时执行swag -v命令判断是否安装成功，会返回以下错误

2、go install

进入gopath下src\github.com\swaggo\swag\cmd\swag路径执行go install命令，可能会报如下错误

此时可以按照1中的git clone方法下载所需包，但是包也可能存在于github.com目录下，如果存在此目录下只需要移动到golang.org/x目录下即可

3、初始化swag

执行完go install命令后如果没有报错出现，就可以cd到项目主目录执行swag init命令初始化swagger了

4、为功能编写swagger注解

package main

import (
    _ "./docs"
    "github.com/gin-gonic/gin"
    "github.com/swaggo/gin-swagger"
    "github.com/swaggo/gin-swagger/swaggerfiles"
    "net/http"
)

// @summary 打印测试功能
// @title swagger example api
// @version 0.0.1
// @description  this is a sample server petstore server.
// @basepath /api/v1
// @host 127.0.0.1:8080
// @produce  json
// @param name query string true "name"
// @success 200 {string} json "{"code":200,"data":"name","msg":"ok"}"
// @router / [get]
func print(context *gin.context) {
    var (
        name string
    )
    name = context.query("name")
    context.json(http.statusok, gin.h{
        "code": http.statusok,
        "msg":  "success",
        "data": name,
    })
}

func main() {
    var (
        route *gin.engine
        v1    *gin.routergroup
    )
    route = gin.default()
    route.get("/swagger/*any", ginswagger.wraphandler(swaggerfiles.handler))
    //gin.setmode(gin.releasemode)
    v1 = route.group("/api/v1")
    {
        v1.get("/", print)
    }

    route.run()
}

 

5、生产swagger文件

 swag init

{
    "swagger": "2.0",
    "info": {
        "description": "this is a sample server petstore server.",
        "title": "swagger example api",
        "contact": {},
        "license": {},
        "version": "0.0.1"
    },
    "host": "127.0.0.1:8080",
    "basepath": "/api/v1",
    "paths": {
        "/": {
            "get": {
                "description": "this is a sample server petstore server.",
                "produces": [
                    "application/json"
                ],
                "summary": "打印测试功能",
                "parameters": [
                    {
                        "type": "string",
                        "description": "name",
                        "name": "name",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "{\"code\":200,\"data\":\"name\",\"msg\":\"ok\"}",
                        "schema": {
                            "type": "string"
                        }
                    }
                }
            }
        }
    }
}

 

6、启动项目展示结果