1.安装 swag

go get github.com/swaggo/swag/cmd/swag
swag 用于生成 docs 文件夹(swagger文档程序使用)安装完成后会在 ${GOPATH}/bin生成一个执行文件

2.编写代码

/*** Created by liuyusnhengsir on 23/01/2022*/package mainimport (_ "lys_gin_swag/docs""github.com/gin-gonic/gin"ginSwagger "github.com/swaggo/gin-swagger""github.com/swaggo/gin-swagger/swaggerFiles"
)// @title lys_gin_swag微服务api
// @version 0.0.1
// @description  lys_gin_swag微服务 code  by 刘云生
// @BasePath /
func main() {r := gin.New()// 创建路由组v1 := r.Group("/api/v1")v1.GET("/sayHello/:name", sayHello)v2 := r.Group("/api/v2")v2.GET("/sayHello/:name", sayHello2)// 文档界面访问URL// http://127.0.0.1:8080/swagger/index.htmlr.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))r.Run(":8080")
}// @sayHello
// @Description sayHello
// @Accept  json
// @Produce json
// @Param   name     path    string     true        "name"
// @Success 200 {string} string    "name,helloWorld"
// @Router /api/v1/sayHello/{name} [get]
func sayHello(c *gin.Context) {name := c.Param("name")c.JSON(200, gin.H{"describe": "this is /api/v1 ","name":     name,})
}// @sayHello2
// @Description sayHello2
// @Accept  json
// @Produce json
// @Param   name     path    string     true        "name"
// @Success 200 {string} string    "name,helloWorld"
// @Router /api/v2/sayHello/{name} [get]
func sayHello2(c *gin.Context) {name := c.Param("name")c.JSON(200, gin.H{"describe": "this is /api/v2","action":   name,})
}

3.swag init

执行 swag init


4.运行效果

go run main.go

进入 http://127.0.0.1:8080/swagger/index.html 查看文档

go集成gin+swagger相关推荐

  1. Kratos 集成Gin

    Kratos 集成 Gin 规范项目分层 处理请求处理.响应 编写路由route Kratos 集成gin 注入 wire set中 源码 Kratos 可以在 .proto文件定义请求类型,URL, ...

  2. 密码学【java】初探究之springboo集成mybatis,swagger,数字签名

    文章目录 项目环境 一 swagger技术的补充 1.1 [swagger]((https://github.com/OAI/OpenAPI-Specification))介绍 1.2 swagger ...

  3. 推荐这款接口管理神器,集成了Swagger和postman,mock的功能

    作为一名开发,日常开发过程中除了写业务代码,前后端联调更是重要的一环.但这一环却往往是整个开发中最繁琐也最累人的一环.任谁都想早点下班,然而提升联调效率并不是个纯技术相关的问题,而是需要有良好工作流程 ...

  4. 09|自研or借力(下):集成Gin替换已有核心

    如何将 Gin 迁移进入我们的框架 在 Golang 中,要在一个项目中引入另外一个项目,一般有两种做法,一种做法是把要引用的项目通过 go mod 引入到目标库中,而另外一种做法则费劲的多,使用复制 ...

  5. 集成gin 、zap和lumberjack

    /*** @author:David Ma* @date:2021-02-01*/package mylogimport ("go.uber.org/zap""go.ub ...

  6. 集成Swagger(API)---SpringBoot

    集成Swagger(API) 学习目标: 了解Swagger的概念及作用 掌握在项目中集成Swagger自动生成API文档 Swagger简介 前后端分离 前端 -> 前端控制层.视图层 后端 ...

  7. Swagger UI 与 Spring Boot 的集成

    Swagger UI 用于生成交互式 API 文档,让您可以直接在浏览器中尝试 REST 服务调用. 在本指南中,让我们构建一个简单的 Spring Boot REST 服务并将 Swagger UI ...

  8. SpringBoot——SpringBoot集成Swagger生成API文档

    文章目录: 1.写在前面 2.步骤详解 2.1 pom文件中添加Swagger依赖 2.2 在application.properties核心配置文件中配置Swagger 2.3 编写需要生成API文 ...

  9. SpringBoot14:集成Swagger终极版

    学习目标: 了解Swagger的概念及作用 掌握在项目中集成Swagger自动生成API文档 Swagger简介 前后端分离 前端 -> 前端控制层.视图层 后端 -> 后端控制层.服务层 ...

最新文章

  1. LED,硅光电池的光能-电能转换是可逆的吗?
  2. 蓝牙MESH网关_水哥智能教学视频一米家蓝牙mesh设备如何升级固件
  3. 多线程与网络之NSURLConnection发送请求
  4. vant 下拉框样式_使用 Vue 的 Vant.js List 列表组件实现无限下拉
  5. 112家it公司薪水
  6. 【数据结构】树状数组详解(Leetcode.315)
  7. 你好,弗朗索瓦丝·萨冈
  8. 春节特惠活动┃数学无用论??我们欠孩子真正的数学阅读
  9. [设计模式]合成复用原则
  10. 浅谈Jfinal急速开发框架
  11. xx云网络实施方案案例
  12. springMVC3学习(十)--注解式控制器
  13. Elasticsearch中的嵌套查询介绍及实例
  14. iOS 指令集架构Architectures armv6、armv7、armv7s、arm64、arm64e、x86_64、i386
  15. xp系统链接不上宽带连接服务器地址,怎么样解决xp电脑宽带连接不见了
  16. 使用 k3d 来运行极狐GitLab Runner
  17. 2018年新浪微博产品笔试题目
  18. “黎明”号新任务继续“锁定”谷神星
  19. 如何一下清空微信好友_微信清理好友方法|微信如何正确清理已删除你的微信好友 微信清理好友方法介绍_东坡下载...
  20. 粤嵌实习-linux下madplay播放器的下载和使用、线程的介绍和创建一个广告循环播放线程

热门文章

  1. 利用xls下载链接下载资源
  2. Android 输入法框架流程整理
  3. php网站mercury安装,mercury300m无线路由器设置教程 教你正确安装无线路由器
  4. OpenGL渲染管线之简单示例(五)
  5. leetcode【135】Candy【c++版,双数组,单数组,坡峰坡谷】
  6. python 小说人物分析_Python文章相关性分析---金庸武侠小说分析
  7. 冈撒雷斯数字图像处理学习笔记
  8. java regux_使用Unix命令在Java中打印Mac的序列号
  9. stata怎么判断是否存在异常值_如何判断stata中有没有某个命令
  10. 苹果计算机能打出分数吗,Apple M1芯片安兔兔跑分曝光:分数打破安兔兔记录