前言

通过之前的两篇文章，可以简单的搭建一个路由网关了。而我们知道，现在都奉行前后端分离开发，前后端开发的沟通成本就增加了，所以一般上我们都是通过swagger进行api文档生成的。现在由于使用了统一路由网关了，都希望各微服务的api文档统一的聚合在网关服务中，也方便前端用户查阅，不需要每个服务单独查看。当然了，也是可以做一个文档索引网页进行各微服务的api文档链接的。今天，我们就来讲下使用swagger实现自动化聚合微服务文档功能。

注：关于Swagger的介绍和使用，由于在之前的SpringBoot系列文章中有提及，这里就不在过多阐述了，不理解的可以点击：第十章：Swagger2的集成和使用进行查看，了解下基本用法。

• Zuul聚合示例
  • 微服务端
  • 路由网关端
• 参考资料
• 总结
• 最后
• 老生常谈

Zuul聚合示例

为了实现自动聚合功能，简单来说就是通过Zuulapi获取所有的路由信息，根据其具体地址进行自动转配到Swagger的SwaggerResource下。

另外，为了项目的独立，本章节创建个maven多模块工程项目。整体结构如下：

同时，会启动一个基于Eureka的注册服务，具体可以查看源码：spring-cloud-eureka-server。

微服务端

为了演示，创建两个微服务spring-cloud-zuul-service-one和spring-cloud-zuul-service-two。

这里以构建spring-cloud-zuul-service-one为例，spring-cloud-zuul-service-two基本上是一样的，可以查看源码示例。

0.引入相关依赖

        <dependency>             <groupId>org.springframework.boot</groupId>             <artifactId>spring-boot-starter-web</artifactId>         </dependency>         <!-- 客户端依赖 -->         <dependency>             <groupId>org.springframework.cloud</groupId>             <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>         </dependency>                <!--swagger -->         <dependency>             <groupId>io.springfox</groupId>             <artifactId>springfox-swagger2</artifactId>             <
                        
关键字：