spring Boot 集成swagger2全过程(代码包含集成Spring Security+ JWT)

1：Spring Boot直接集成
   1）maven添加Swagger2的依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.8.0</version>
</dependency>
    2）application.yml配置
spring:
    resources:
    add-mappings: true

springfox:
    documentation:
        swagger:
            v2:
                path: /api-docs

    3)添加Swagger2配置类

    4)controller方法上进行swagger注解

    5)这样最基本的Spring Boot集成swagger就完成了，访问host:port/swagger-ui.html就可以访问了

2:集成spring security和jwt
    1)配置SecurityConfiguration的web.ignoring().antMatchers("/api-docs", "/swagger-resources/**", "/swagger-ui.html**", "/webjars/**")

    2）修改Swagger2配置，加上
    .securitySchemes(newArrayList(apiKey()))
    .securityContexts(newArrayList(securityContext()))

    3）做完上面两步就可以添加token认证了

3：配合Spring Cloud Zuul进行集中式整合Swagger文档到同一个页面上,除了网关之外的微服务只需要实现上面两步就可以了（第2步中除网关外的微服务不需要配置SecurityConfiguration，只需要修改Swagger2配置）

    1）添加DocumentationConfig类继承SwaggerResourcesProvider

    2)配置SecurityConfiguration的web.ignoring().antMatchers("/api-docs", "/swagger-resources/**", "/swagger-ui.html**", "/webjars/**","/medical-provider/api-docs")

    3)这样就可以就行集中管理了

4：通过Eureka的链接跳转到Swagger-ui页面

    1）在application.yml加上如下配置即可
        eureka:       
            instance:
                status-page-url: http://localhost:${server.port}/swagger-ui.html