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