微服务需要聚合工程吗_网光如何聚合各个微服务的接口文档？

背景

在之前老顾的文章中，介绍过利用swagger实现api文档，我们每个微服务都有自己的一套api接口，那我们开发人员进行开发的时候，是需要打开很多api接口文档地址，太麻烦了，那能不能只打开一个接口地址，此地址聚合了下游服务的所有api接口文档地址？

微服务Api接口配置

pom依赖包

Swagger配置

上面的配置不单单支持了接口文档，而且还只是多版本的接口文档配置，当然需要一些定制代码，看下面：

接口版本

接口版本定义

配置使用

上面的配置就是每个微服务的接口文档配置

注意如果有相关授权配置需要把相关的swagger的url地址配置成不需要授权

/doc.html,/swagger-ui.html,/webjars/,/v2/,/swagger-resources/

网关配置

pom引入依赖包

因为Swagger暂不支持webflux项目，所以Gateway里不能配置SwaggerConfig，也就是说Gateway无法提供自身API。但一般也不会在网关项目代码里写业务API代码。所以这里的集成只是基于WebMvc的微服务项目。

上面的代码就是把网关的路由解析出来，然后设置SwaggerResource；多版本的设置是基于/v2/api-docs?group=原理：

配置网关路由

启动测试

访问网关地址http://localhost:8769/doc.html

总结

这样就做到了只要访问网关的api文档地址，左上角进行项目接口版本切换。小伙伴有没有注意到文档的界面大有不同，就是引入了。

   com.github.xiaoymin

   swagger-bootstrap-ui

   1.9.3

这个UI左右结构，非常方便，小伙伴可以自行体验一下哦。

往期精选

CHOICENESS

是兄弟，就来 “kan” 我