前面文章已经搭建了本地的easy-mock
前后端接口联调需要API文档,我们经常会使用工具来生成。之前经常使用Swagger来生成,最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点,推荐给大家。
2025年04月11日
前后端接口联调需要API文档,我们经常会使用工具来生成。之前经常使用Swagger来生成,最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点,推荐给大家。
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是希望她能像一把匕首一样小巧,轻量,并且功能强悍!