springcloud gateway聚合swagger2的方法示例
問題描述
在搭建分布式應(yīng)用時,每個應(yīng)用通過nacos在網(wǎng)關(guān)出裝配了路由,我們希望網(wǎng)關(guān)也可以將所有的應(yīng)用的swagger界面聚合起來。這樣前端開發(fā)的時候只需要訪問網(wǎng)關(guān)的swagger就可以,而不用訪問每個應(yīng)用的swagger。
框架
springcloud+gateway+nacos+swagger
問題分析
swagger頁面是一個單頁面應(yīng)用,所有的顯示的數(shù)據(jù)都是通過和springfox.documentation.swagger.web.ApiResponseController進(jìn)行數(shù)據(jù)交互,首先通過/swagger-resources獲取swagger資源信息,獲取的信息格式如下:[{name: "default", url: "/v2/api-docs", swaggerVersion: "2.0", location: "/v2/api-docs"}],其中name代表swagger生成的接口組的組名,如圖所示:
url
代表swagger接口組的詳細(xì)信息可以通過 localhost:8081/v2/api-docs來獲取,如下圖:
在網(wǎng)關(guān)處,如果訪問/swagger-resources能夠獲取到所有應(yīng)用的swagger的資源信息,那么我們的問題就可以解決了,所以我們需要做的是修改/swagger-resources接口的處理方式,使得這個接口能夠按照我們的需求返回swagger資源。
解決方案
我們首先在網(wǎng)關(guān)處引入swagger的相關(guān)依賴,然后實現(xiàn)一個獲取其他應(yīng)用的swagger資源的組件:
/** * 聚合各個服務(wù)的swagger接口 * * @author ksyzz * @since <pre>2019/04/09</pre> */ @Component public class MySwaggerResourceProvider implements SwaggerResourcesProvider { /** * swagger2默認(rèn)的url后綴 */ private static final String SWAGGER2URL = "/v2/api-docs"; /** * 網(wǎng)關(guān)路由 */ private final RouteLocator routeLocator; /** * 網(wǎng)關(guān)應(yīng)用名稱 */ @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<>(); // 由于我的網(wǎng)關(guān)采用的是負(fù)載均衡的方式,因此我需要拿到所有應(yīng)用的serviceId // 獲取所有可用的host:serviceId routeLocator.getRoutes().filter(route -> route.getUri().getHost() != null) .filter(route -> !self.equals(route.getUri().getHost())) .subscribe(route -> routeHosts.add(route.getUri().getHost())); // 記錄已經(jīng)添加過的server,存在同一個應(yīng)用注冊了多個服務(wù)在nacos上 Set<String> dealed = new HashSet<>(); routeHosts.forEach(instance -> { // 拼接url,樣式為/serviceId/v2/api-info,當(dāng)網(wǎng)關(guān)調(diào)用這個接口時,會自動通過負(fù)載均衡尋找對應(yīng)的主機(jī) String url = "/" + instance + SWAGGER2URL; if (!dealed.contains(url)) { dealed.add(url); SwaggerResource swaggerResource = new SwaggerResource(); swaggerResource.setUrl(url); swaggerResource.setName(instance); resources.add(swaggerResource); } }); return resources; } }
然后定義一個接口類:
/** * swagger聚合接口,三個接口都是swagger-ui.html需要訪問的接口 * * @author ksyzz * @since <pre>2019/04/09</pre> */ @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); } }
然后啟動網(wǎng)關(guān),訪問 http://網(wǎng)關(guān)地址/swagger-ui.html,可以看到
在箭頭處,可以切換不同應(yīng)用的swagger頁面。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- 詳解Spring Cloud Gateway 限流操作
- spring cloud gateway使用 uri: lb://方式配置時,服務(wù)名的特殊要求
- 基于Nacos實現(xiàn)Spring Cloud Gateway實現(xiàn)動態(tài)路由的方法
- 解決spring cloud gateway 獲取body內(nèi)容并修改的問題
- springcloud gateway如何實現(xiàn)路由和負(fù)載均衡
- 詳解SpringCloud Gateway之過濾器GatewayFilter
- Spring Cloud Gateway全局異常處理的方法詳解
- spring cloud gateway整合sentinel實現(xiàn)網(wǎng)關(guān)限流
- Spring?Cloud?Gateway編碼實現(xiàn)任意地址跳轉(zhuǎn)
相關(guān)文章
java中fastjson生成和解析json數(shù)據(jù)(序列化和反序列化數(shù)據(jù))
本篇文章主要介紹了java中fastjson生成和解析json數(shù)據(jù)(序列化和反序列化數(shù)據(jù)),具有一定的參考價值,感興趣的小伙伴們可以參考一下。2017-02-02java 實現(xiàn)圖片像素質(zhì)量壓縮與圖片長寬縮放
這篇文章主要介紹了java 實現(xiàn)圖片像素質(zhì)量壓縮與圖片長寬縮放,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-11-11微服務(wù)springcloud 03.Eureka實現(xiàn)高可用的過程
這篇文章主要介紹了微服務(wù)springcloud 03.Eureka實現(xiàn)高可用的相關(guān)資料,本文給大家介紹的非常詳細(xì),需要的朋友可以參考下2024-07-07