3、微服务整合Swagger3.0 - 网关Gateway聚合接口
前置基础默认大家已经会了Gateway网关,Nacos注册中心,Swagger配置!
个人建议大家使用Knife4j,因为它的前身是swagger-bootstrap-ui,是在Swagger的基础上进行了界面的优化,使用起来比Swagger舒服太多了!
一、整合步骤
1、在网关模块、抽取出的公共swagger模块的pom文件添加knife4j的依赖
<!-- knife4j -->
<!-- 在公共模块可不加knife4j-spring-ui -->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-ui</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
Knife4j本身已经引入了springfox,在使用时不用再单独引入Springfox的具体版本,否则会导致版本冲突。
2、在网关模块的配置类SwaggerProvider.java追加注解@Primary
不添加会报错!
二、测试效果
访问地址:http://{ip}:{port}/doc.html
总结:以上为个人经验,希望能给大家一个参考!