swagger换新UI

swagger

很多同学,尤其是做前后端分离开发,会在后端项目中加入swagger来自动生成文档,而且也能进行简单的接口测试,但是官方的ui很简陋而且并不是很贴合国人的审美和操作,所以一般会引入第三方的swagger-ui

swagger-bootstrap-ui

这是国人编写的一个swagger-ui,样式如下:

maven仓库依赖:

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
    <version>1.9.6</version>
</dependency>

但是如果有去maven仓库搜索过就会发现,这个最后更新时间已经是2019年了

knife4j-spring-ui

其实是作者对该项目进行了重构,更名为Knife4j,最后更新时间为2021年6月

新ui样式如下,看起来会比之前的高级一点(主观)

替换样式非常简单,删除原来的swagger-bootstrap-ui依赖,更换为knife4j-spring-ui依赖,重启服务,访问你自定义的路径即可

旧依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
    <version>1.9.6</version>
</dependency>

新依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-ui</artifactId>
    <version>3.0.3</version>
</dependency>

项目地址

项目github仓库地址,点击跳转