SpringCloud搭建专题【gateway统一管理swaggerApi】

SpringCloud搭建专题【网关统一管理swagger】

所有的业务服务正常配置swagger即可，不需要引入swagger-ui,统一在gateway上配置。

从这开始就是gateway的配置，其余的eurekaclient和正常的单机项目一样配置即可

首先在已经创建好的gateway微服务中引入swagger jar包

        <dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger2</artifactId>
			<version>2.9.2</version>
		</dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

声明gateway中不需要配置下面这些,否则就会疯狂报错

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket docket(){
        return  new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .enable(true)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.basecloud.auth.controller"))
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                //页面标题
                .title("Auth Restful Api")
                //创建人
                .contact(new Contact("yujian", "http://www.basecloud.com/", ""))
                //版本号
                .version("1.0")
                //描述
                .description("API 描述")
                .build();
    }
}

先拿配置文件来讲，根据路径名称转发，让网关转发到http://localhost:8099/auth/v2/api-docs的路径上去，就会请求到注册为BASECLOUD-AUTH的服务（localhost:8091/v2/api-docs）拿到json

网关转发的地址：

实际swagger的地址（auth服务）

ok看到这里大概就能明白是如何统一管理swagger的了，我这里还单独配置了转发路径

swagger:
   names: auth,shop

然后配置swaggerResource的集合，下面是配置类

@Component
@Primary
public class SwaggerResourcesConfig implements SwaggerResourcesProvider{

    @Value("${swagger.names}")
    private String[] apiNames;
    @Override
    public List<SwaggerResource> get() {
        List<SwaggerResource> collect = Arrays.asList(apiNames).stream().map(name -> {
            SwaggerResource swaggerResource = swaggerResource(name,  "/"+name+"/v2/api-docs");
            return swaggerResource;
        }).collect(Collectors.toList());

        return collect;
    }

    private SwaggerResource swaggerResource(String serviceId, String location){

        SwaggerResource swaggerResource = new SwaggerResource();
        swaggerResource.setName(serviceId);
        swaggerResource.setLocation(location);
        swaggerResource.setSwaggerVersion("2.0");
        return swaggerResource;
    }
}

到这就皆大欢喜，踩了一下午的坑，各种bug…，希望不会再有人踩坑了，如果帮到了你点个赞谢谢啦！

来源：https://blog.csdn.net/Day_Day_No_Bug/article/details/102728302