Java高级教程之SpringCloud-19:SpringCloud Swagger整合网关路由微服务Zuul

网关中心与文档中心整合,首先在micro-service-api-gateway微服务工程中加入swagger依赖。

Java高级教程之SpringCloud-19:SpringCloud Swagger整合网关路由微服务Zuul

 

另外在ApplicationMain类上面加入swagger注解@EnableSwagger2Doc,还要加入一个类ApiGatewaySwaggerResourcesProvider。

 

package com.lpplpp.gateway.app;

import com.spring4all.swagger.EnableSwagger2Doc;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;
import org.springframework.context.annotation.Primary;
import org.springframework.stereotype.Component;
import springfox.documentation.swagger.web.SwaggerResource;
import springfox.documentation.swagger.web.SwaggerResourcesProvider;

import java.util.ArrayList;
import java.util.List;

@SpringBootApplication
@EnableZuulProxy
@EnableSwagger2Doc
public class ApplicationMain {
    public static void main(String[] args) {
        SpringApplication.run(ApplicationMain.class, args);
        System.out.println("gateway microservice is running");
    }

    @Component
    @Primary
    class ApiGatewaySwaggerResourcesProvider implements SwaggerResourcesProvider {
        @Override
        public List get() {
            List resource=new ArrayList<>();
            resource.add(swaggerResource("product-service","/product-service/v2/api-docs?token=1","1.0"));
            resource.add(swaggerResource("order-service","/order-service/v2/api-docs?token=1","1.0"));
            return resource;
        }

        private SwaggerResource swaggerResource(String name,String location,String version){
            SwaggerResource swaggerResource=new SwaggerResource();
            swaggerResource.setName(name);
            swaggerResource.setLocation(location);
            swaggerResource.setSwaggerVersion(version);
            return swaggerResource;
        }
    }

}

重新启动网关服务,访问swagger-ui.html地址查看API文档中心,可以看到已经有两个微服务spec文档product-service和order-service。

 

Java高级教程之SpringCloud-19:SpringCloud Swagger整合网关路由微服务Zuul