spring-gateway网关聚合swagger实现多个服务接口切换的示例代码

package com.zmy.springcloud.config;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.beans.factory.annotation.Value;

import org.springframework.cloud.gateway.route.RouteLocator;

import org.springframework.stereotype.Component;

import springfox.documentation.swagger.web.SwaggerResource;

import springfox.documentation.swagger.web.SwaggerResourcesProvider;

import java.util.*;

/**

  * 聚合各个服务的swagger接口

  */

@Component

public class MySwaggerResourceProvider implements SwaggerResourcesProvider {

     /**

      * swagger2默认的url后缀

      */

     private static final String SWAGGER2URL = "/v2/api-docs" ;

     /**

      * 网关路由

      */

     private final RouteLocator routeLocator;

     /**

      * 网关应用名称

      */

     @Value ( "${spring.application.name}" )

     private String self;

     @Autowired

     public MySwaggerResourceProvider(RouteLocator routeLocator) {

         this .routeLocator = routeLocator;

     }

     @Override

     public List<SwaggerResource> get() {

         List<SwaggerResource> resources = new ArrayList<>();

         List<String> routeHosts = new ArrayList<>();

         // 获取所有可用的host：serviceId

         routeLocator.getRoutes().filter(route -> route.getUri().getHost() != null )

                 .filter(route -> !self.equals(route.getUri().getHost()))

                 .subscribe(route -> routeHosts.add(route.getUri().getHost()));

         // 记录已经添加过的server

         Set<String> dealed = new HashSet<>();

         routeHosts.forEach(instance -> {

             // 拼接url

             String url = "/" + instance.toLowerCase() + SWAGGER2URL;

             if (!dealed.contains(url)) {

                 dealed.add(url);

                 SwaggerResource swaggerResource = new SwaggerResource();

                 swaggerResource.setUrl(url);

                 swaggerResource.setName(instance);

                 resources.add(swaggerResource);

             }

         });

         return resources;

     }

}

package com.zmy.springcloud.config.swagger.controller;

import com.zmy.springcloud.config.MySwaggerResourceProvider;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.http.HttpStatus;

import org.springframework.http.ResponseEntity;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

import springfox.documentation.swagger.web.*;

import java.util.List;

/**

  * swagger聚合接口，三个接口都是swagger-ui.html需要访问的接口

  */

@RestController

@RequestMapping ( "/swagger-resources" )

public class SwaggerResourceController {

     private MySwaggerResourceProvider swaggerResourceProvider;

     @Autowired

     public SwaggerResourceController(MySwaggerResourceProvider swaggerResourceProvider) {

         this .swaggerResourceProvider = swaggerResourceProvider;

     }

     @RequestMapping (value = "/configuration/security" )

     public ResponseEntity<SecurityConfiguration> securityConfiguration() {

         return new ResponseEntity<>(SecurityConfigurationBuilder.builder().build(), HttpStatus.OK);

     }

     @RequestMapping (value = "/configuration/ui" )

     public ResponseEntity<UiConfiguration> uiConfiguration() {

         return new ResponseEntity<>(UiConfigurationBuilder.builder().build(), HttpStatus.OK);

     }

     @RequestMapping

     public ResponseEntity<List<SwaggerResource>> swaggerResources() {

         return new ResponseEntity<>(swaggerResourceProvider.get(), HttpStatus.OK);

     }

}

<dependency>

     <groupId>org.springframework.cloud</groupId>

     <artifactId>spring-cloud-starter-gateway</artifactId>

</dependency>

<!--swagger生成API文档-->

<dependency>

     <groupId>io.springfox</groupId>

     <artifactId>springfox-swagger2</artifactId>

     <version> 2.9 . 2 </version>

     <exclusions>

         <exclusion>

             <groupId>io.swagger</groupId>

             <artifactId>swagger-models</artifactId>

         </exclusion>

     </exclusions>

</dependency>

<dependency>

     <groupId>io.swagger</groupId>

     <artifactId>swagger-models</artifactId>

     <version> 1.5 . 22 </version>

</dependency>

<dependency>

     <groupId>io.springfox</groupId>

     <artifactId>springfox-swagger-ui</artifactId>

     <version> 2.9 . 2 </version>

</dependency>

<!--nacos-->

<dependency>

     <groupId>com.alibaba.cloud</groupId>

     <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>

</dependency>

server:

   port: 9527

spring:

   application:

     name: cloud-gateway

   cloud:

     gateway:

       routes:

         - id: seata-storage-service

           uri: lb: //seata-storage-service

           predicates:

             - Path=/seata-storage-service/**         # 断言，相匹配的进行路由

           filters:

             - StripPrefix= 1

         - id: seata-account-service

           uri: lb: //seata-account-service

             - Path=/seata-account-service/**

       discovery:

         locator:

           enabled: true #开启从注册中心动态创建路由的功能，利用微服务名进行路由

     nacos:

         server-addr: localhost: 8848

server:

   servlet:

     context-path: /seata-order-service