springcloud+zuul+swagger 分布式接口文档

https://gitee.com/didispace/swagger-butler

1.引用上面项目中的swagger 工具包

2.zuul 网关配置

zuul.routes.api-apiservice.path=/apiservice/**
zuul.routes.api-apiservice.serviceId=apiservice
zuul.routes.operation-managerment-service.path=/operation-managerment-service/**
zuul.routes.operation-managerment-service.serviceId=operation-managerment-service
 
#swagger 配置
#通过网关获取服务地址
swagger.butler.auto-generate-from-zuul-routes=true
#配置需要显示swagger接口服务的路由名称
swagger.butler.generate-routes=api-apiservice,operation-managerment-service

swagger.butler.generate-routes 配置需要显示服务的路由名称，如果有多个 “，”g隔开
接着zuul启动类上面添加注解

@SpringBootApplication
@EnableZuulProxy
// 短路监控
@EnableHystrixDashboard
//swagger注解
@EnableSwaggerButler
public class ZuulApplication {
    public static void main(String[] args) throws Exception {
        SpringApplication.run(ZuulApplication.class, args);
    }

网关层配置就完成了，接下来只要在应用服务中引用包就可以了

4.对应的应用服务的pom文件中引用上面的swagger工具包，在启动类上配置注解

@SpringBootApplication
@EnableDiscoveryClient
@EnableSwaggerButler
public class ApiserviceApplication {
 
    public static void main(String[] args) {
        SpringApplication.run(ApiserviceApplication.class, args);
    }
 
}

访问：http://localhost:8082//swagger-ui.html