2019-06-27 微服务swagger 整合

zuul网关， 微服务有member  和order， 我们在网关中配置 对应的swagger 映射到 member 和order， 实现微服务swagger 整合 springcloud

必须步骤其实很简单：一、 member 与order中，1、导入swagger 与springboot 整合包；2、application.yml中 配置扫描包 ；3、程序入口类加上@EnableSwagger2Doc 注解，完成。 二、zuul 中 ， 1、加入swagger 与springboot 整合包；2、程序入口类加上注解@EnableSwagger2Doc ， 加一个内部类实现SwaggerResourcesProvider接口。 完成。

详细说明如下：

步骤：

1、 微服务member 与order 中 ：

（1）导入jar包

<dependency>

    <groupId>com.spring4all</groupId>

    <artifactId>swagger-spring-boot-starter</artifactId>

    <version>1.7.0.RELEASE</version>

</dependency>

（2）application.yml 中配置扫描包

swagger:

    base-package: com.zbiti.zz.member.api.controller

（3）程序主类加上 @EnableSwagger2Doc注解 或者 controller上加@EnableSwagger2Doc注解

mebber 程序入口类相应注解

（4）controller 中可以加对应方法以及参数说明， 如果不加，则swagger 采用默认的。

controller中可以使用的部分注解

2、网关zuul 中的配置：

（1）同上导入swagger

(2)

程序入口类加上@EnableSwagger2Doc注解

加入一个内部类 实现SwaggerResourcesProvider接口。如下图

zuul中swagger的相应内容

3、访问 localhost:1010/swagger-ui.html . 这是访问的zuul 端口。 完成！