最近简单的学习了一下Golang,并且用Gin开发了两个小应用,一个短域名生成,一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候,需要生成接口文档,这里需要用到Gin-Swagger了,所以简单的就来整理一下。
这里我用的环境是:
- go version go1.14.6 windows/amd64
- GoLand 2020.2.1
- gin v1.6.3
2025年04月11日
最近简单的学习了一下Golang,并且用Gin开发了两个小应用,一个短域名生成,一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候,需要生成接口文档,这里需要用到Gin-Swagger了,所以简单的就来整理一下。
这里我用的环境是:
2025年04月11日
当我们使用swagger,进行接口测试,怕接口不安全,担心暴露。可以采用两种方式
可以对swagger文档配置只在测试环境可访问,生产环境不可访问。
@Profile({"dev","test"})
2025年04月11日
最近学习go语言,使用gin框架,在整合knife4j swagger时,发现资料非常少,整合之后也有很多不如意,所以自己整合了一个学习项目:项目地址
https://gitee.com/longyancang/knife4jgo
1.支持自定义panic拦截器
2.支持参数验证错误描述拦截
3.支持自定义响应体
2025年04月11日
swagger作为一款在线文档生成工具,用于自动生成接口API,避免接口文档和代码不同步,但原生的界面不是很友好,下面介绍一款改进版本swagger-bootstrap-ui,界面左右侧布局,可以打开多个Tab页。
实现也非常简单,在swagger2配置基础上仅多添加一个依赖并在配置类上追加@EnableSwaggerBootstrapUI注解即可,无任何其他多余配置。
看下Springboot集成步骤:
2025年04月11日
Knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案,前身是swagger-bootstrap-ui,取名kni4j是希望她能像一把匕首一样小巧,轻量,并且功能强悍!
2025年04月11日
在当今互联网大厂开发的快节奏环境中,高效且清晰的接口文档对于项目的顺利推进至关重要。对于使用 Spring Boot3 进行开发的你来说,是否渴望找到一种便捷的方式来整合 Swagger3,从而轻松实现超酷的在线接口文档展示呢?别着急,本文将为你一一揭晓。