中文字幕av专区_日韩电影在线播放_精品国产精品久久一区免费式_av在线免费观看网站

溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點擊 登錄注冊 即表示同意《億速云用戶服務條款》

SpringCloud?Gateway服務網關的部署與使用的方法是什么

發布時間:2023-04-04 11:44:11 來源:億速云 閱讀:153 作者:iii 欄目:開發技術

這篇文章主要介紹“SpringCloud Gateway服務網關的部署與使用的方法是什么”的相關知識,小編通過實際案例向大家展示操作過程,操作方法簡單快捷,實用性強,希望這篇“SpringCloud Gateway服務網關的部署與使用的方法是什么”文章能幫助大家解決問題。

    一、為什么需要服務網關:

    1、什么是服務網關:

            傳統的單體架構中只需要開放一個服務給客戶端調用,但是微服務架構中是將一個系統拆分成多個微服務,如果沒有網關,客戶端只能在本地記錄每個微服務的調用地址,當需要調用的微服務數量很多時,它需要了解每個服務的接口,這個工作量很大。那有了網關之后,能夠起到怎樣的改善呢?

            網關作為系統的唯一流量入口,封裝內部系統的架構,所有請求都先經過網關,由網關將請求路由到合適的微服務,所以,使用網關的好處在于:

    • (1)簡化客戶端的工作。網關將微服務封裝起來后,客戶端只需同網關交互,而不必調用各個不同服務;

    • (2)降低函數間的耦合度。 一旦服務接口修改,只需修改網關的路由策略,不必修改每個調用該函數的客戶端,從而減少了程序間的耦合性

    • (3)解放開發人員把精力專注于業務邏輯的實現。由網關統一實現服務路由(灰度與ABTest)、負載均衡、訪問控制、流控熔斷降級等非業務相關功能,而不需要每個服務 API 實現時都去考慮

            但是 API 網關也存在不足之處,在微服務這種去中心化的架構中,網關又成了一個中心點或瓶頸點,它增加了一個我們必須開發、部署和維護的高可用組件。正是由于這個原因,在網關設計時必須考慮即使 API 網關宕機也不要影響到服務的調用和運行,所以需要對網關的響應結果有數據緩存能力,通過返回緩存數據或默認數據屏蔽后端服務的失敗。

            在服務的調用方式上面,網關也有一定的要求,API 網關最好是支持 I/O 異步、同步非阻塞的,如果服務是同步阻塞調用,可以理解為微服務模塊之間是沒有徹底解耦的,即如果A依賴B提供的API,如果B提供的服務不可用將直接影響到A不可用,除非同步服務調用在API網關層或客戶端做了相應的緩存。因此為了徹底解耦,在微服務調用上更建議選擇異步方式進行。而對于 API 網關需要通過底層多個細粒度的 API 組合的場景,推薦采用響應式編程模型進行而不是傳統的異步回調方法組合代碼,其原因除了采用回調方式導致的代碼混亂外,還有就是對于 API 組合本身可能存在并行或先后調用,對于采用回調方式往往很難控制。

    2、服務網關的基本功能:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    3、流量網關與服務網關的區別:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

            流量網關和服務網關在系統整體架構中所處的位置如上圖所示,流量網關(如Nignx)是指提供全局性的、與后端業務應用無關的策略,例如 HTTPS證書卸載、Web防火墻、全局流量監控等。而微服務網關(如Spring Cloud Gateway)是指與業務緊耦合的、提供單個業務域級別的策略,如服務治理、身份認證等。也就是說,流量網關負責南北向流量調度及安全防護,微服務網關負責東西向流量調度及服務治理。

    二、服務網關的部署:

    1、主流網關的對比與選型:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

     (1)Kong 網關:Kong 的性能非常好,非常適合做流量網關,但是對于復雜系統不建議業務網關用 Kong,主要是工程性方面的考慮

    (2)Zuul1.x 網關:Zuul 1.0 的落地經驗豐富,但是性能差、基于同步阻塞IO,適合中小架構,不適合并發流量高的場景,因為容易產生線程耗盡,導致請求被拒絕的情況

    (3)gateway 網關:功能強大豐富,性能好,官方基準測試 RPS (每秒請求數)是Zuul的1.6倍,能與 SpringCloud 生態很好兼容,單從流式編程+支持異步上也足以讓開發者選擇它了。

    (4)Zuul 2.x:性能與 gateway 差不多,基于非阻塞的,支持長連接,但 SpringCloud 沒有集成 zuul2 的計劃,并且 Netflix 相關組件都宣布進入維護期,前景未知。

            綜上,gateway 網關更加適合 SpringCloud 項目,而從發展趨勢上看,gateway 替代 zuul 也是必然的。

    2、Spring Cloud Gateway 網關的搭建:

    (1)聲明依賴版本號:

    	<properties>
    		<spring-boot.version>2.3.2.RELEASE</spring-boot.version>
    		<spring-cloud.version>Hoxton.SR9</spring-cloud.version>
    		<spring-cloud-alibaba.version>2.2.6.RELEASE</spring-cloud-alibaba.version>
    	</properties>
     
    	<!-- 只聲明依賴,不引入依賴 -->
    	<dependencyManagement>
    		<dependencies>
    			<!-- 聲明springBoot版本 -->
    			<dependency>
    				<groupId>org.springframework.boot</groupId>
    				<artifactId>spring-boot-dependencies</artifactId>
    				<version>${spring-boot.version}</version>
    				<type>pom</type>
    				<scope>import</scope>
    			</dependency>
    			<!-- 聲明springCloud版本 -->
    			<dependency>
    				<groupId>org.springframework.cloud</groupId>
    				<artifactId>spring-cloud-dependencies</artifactId>
    				<version>${spring-cloud.version}</version>
    				<type>pom</type>
    				<scope>import</scope>
    			</dependency>
    			<!-- 聲明 springCloud Alibaba 版本 -->
    			<dependency>
    				<groupId>com.alibaba.cloud</groupId>
    				<artifactId>spring-cloud-alibaba-dependencies</artifactId>
    				<version>${spring-cloud-alibaba.version}</version>
    				<type>pom</type>
    				<scope>import</scope>
    			</dependency>
    		</dependencies>
    	</dependencyManagement>

    (2)添加依賴:

    <!-- 引入gateway網關 -->
    <dependency>
    	<groupId>org.springframework.cloud</groupId>
    	<artifactId>spring-cloud-starter-gateway</artifactId>
    	<exclusions>
            <exclusion>
    			<groupId>org.springframework.boot</groupId>
            	<artifactId>spring-boot-starter-web</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    注意:一定要排除掉 spring-boot-starter-web 依賴,否則啟動報錯

    (3)配置項目名與端口:

    server:
      port: 9023
      servlet:
        context-path: /${spring.application.name}
    spring:
      application:
        name: gateway

    好了,網關項目搭建完成,其實就添加這么一個依賴,關于詳細的配置以及作用下文介紹。

    3、Spring Cloud Gateway 配置項的說明:

            在介紹 Spring Cloud Gateway 的配置項之前,我們先了解幾個 Spring Cloud Gateway 的核心術語:

    • 斷言(Predicate):參照 Java8 的新特性Predicate,允許開發人員匹配 HTTP 請求中的任何內容,比如請求頭或請求參數,最后根據匹配結果返回一個布爾值。

    • 路由(route):由ID、目標URI、斷言集合和過濾器集合組成。如果聚合斷言結果為真,則轉發到該路由。

    • 過濾器(filter):可以在返回請求之前或之后修改請求和響應的內容。

    3.1、路由 Route:

            Route 主要由 路由id、目標uri、斷言集合和過濾器集合組成,那我們簡單看看這些屬性到底有什么作用。

    (1)id:路由標識,要求唯一,名稱任意(默認值 uuid,一般不用,需要自定義)

    (2)uri:請求最終被轉發到的目標地址

    (3)order: 路由優先級,數字越小,優先級越高

    (4)predicates:斷言數組,即判斷條件,如果返回值是boolean,則轉發請求到 uri 屬性指定的服務中

    (5)filters:過濾器數組,在請求傳遞過程中,對請求做一些修改

    3.2、斷言 Predicate:

            Predicate 來自于 Java8 的接口。Predicate 接受一個輸入參數,返回一個布爾值結果。該接口包含多種默認方法來將 Predicate 組合成其他復雜的邏輯(比如:與,或,非)。

            Predicate 可以用于接口請求參數校驗、判斷新老數據是否有變化需要進行更新操作。Spring Cloud Gateway 內置了許多 Predict,這些 Predict 的源碼在 org.springframework.cloud.gateway.handler.predicate 包中,有興趣可以閱讀一下。內置的一些斷言如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    以上11種斷言這里就不再介紹如何配置了,官方文檔寫的很清楚:https://docs.spring.io/spring-cloud-gateway/docs/2.2.9.RELEASE/reference/html/

    下面就以最后一種權重斷言為例介紹一下如何配置。配置如下:

    spring:
      cloud:
        gateway:
          # 路由數組:指當請求滿足什么樣的斷言時,轉發到哪個服務上
          routes:
            # 路由標識,要求唯一,名稱任意
            - id: gateway-provider_1
    		  # 請求最終被轉發到的目標地址
              uri: http://localhost:9024
              # 設置斷言
              predicates:
                # Path Route Predicate Factory 斷言,滿足 /gateway/provider/** 路徑的請求都會被路由到 http://localhost:9024 這個uri中
                - Path=/gateway/provider/**
                # Weight Route Predicate Factory 斷言,同一分組按照權重進行分配流量,這里分配了80%
                # 第一個group1是分組名,第二個參數是權重
                - Weight=group1, 8
              # 配置過濾器(局部)
              filters:
                # StripPrefix:去除原始請求路徑中的前1級路徑,即/gateway
                - StripPrefix=1            
                
            - id: gateway-provider_2
              uri: http://localhost:9025
              # 設置斷言
              predicates:
                - Path=/gateway/provider/**
                # Weight Route Predicate Factory,同一分組按照權重進行分配流量,這里分配了20%
                - Weight=group1, 2
    		  # 配置過濾器(局部)
              filters:
                # StripPrefix:去除原始請求路徑中的前1級路徑,即/gateway
                - StripPrefix=1

            Spring Cloud Gateway 中的斷言命名都是有規范的,格式:“xxx + RoutePredicateFactory”,比如權重斷言 WeightRoutePredicateFactory,那么配置時直接取前面的 “Weight”。

            如果路由轉發匹配到了兩個或以上,則是的按照配置先后順序轉發,上面都配置了路徑:“ Path=/gateway/provider/** ”,如果沒有配置權重,則肯定是先轉發到 “http://localhost:9024”,但是既然配置配置了權重并且相同的分組,則按照權重比例進行分配流量。

    3.3、過濾器 filter:

    Gateway 過濾器的生命周期:

    • PRE:這種過濾器在請求被路由之前調用。我們可利用這種過濾器實現身份驗證、在集群中選擇請求的微服務、記錄調試信息等。

    • POST:這種過濾器在路由到微服務以后執行。這種過濾器可用來為響應添加標準的 HTTP Header、收集統計信息和指標、將響應從微服務發送給客戶端等。

    Gateway 過濾器從作用范圍可分為兩種:

    • GatewayFilter:應用到單個路由或者一個分組的路由上(需要在配置文件中配置)

    • GlobalFilter:應用到所有的路由上(無需配置,全局生效)

    (1)局部過濾器 GatewayFilter:

            Spring Cloud Gateway 中內置了許多的局部過濾器,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

             局部過濾器需要在指定路由配置才能生效,默認是不生效的。以 “AddResponseHeaderGatewayFilterFactory” 這個過濾器為例,為原始響應添加Header,配置如下:

    spring:
      cloud:
        gateway:
          routes:
            - id: gateway-provider_1
              uri: http://localhost:9024
              predicates:
                - Path=/gateway/provider/**
              # 配置過濾器(局部)
              filters:
                - AddResponseHeader=X-Response-Foo, Bar
                # StripPrefix:去除原始請求路徑中的前1級路徑,即/gateway
                - StripPrefix=1

    瀏覽器請求,發現響應頭中已經有了 X-Response-Foo=Bar 這個鍵值對,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

            在前面的示例中,我們也使用到了另一個局部過濾器 StripPrefixGatewayFilterFactory,該過濾器主要用于截斷原始請求的路徑,當我們請求 localhost:9023/gateway/provider/test 時,實際請求會被轉發到 http://localhost:9024 服務上,并被截斷成 “http://localhost:9024/provider/test"

    注意:過濾器的名稱只需要寫前綴,過濾器命名必須是 "xxx + GatewayFilterFactory“(包括自定義)。

    更多過濾器的配置參考官方文檔:https://docs.spring.io/spring-cloud-gateway/docs/2.2.9.RELEASE/reference/html/#gatewayfilter-factories

    (2)自定義局部過濾器:

            雖說內置的過濾器能夠解決很多場景,但是難免還是有些特殊需求需要定制一個過濾器,下面就來介紹一下如何自定義局部過濾器。

    /**
     * 名稱必須是xxxGatewayFilterFactory形式
     * todo:模擬授權的驗證,具體邏輯根據業務完善
     */
    @Component
    @Slf4j
    public class AuthorizeGatewayFilterFactory extends AbstractGatewayFilterFactory<AuthorizeGatewayFilterFactory.Config> {
     
        private static final String AUTHORIZE_TOKEN = "token";
     
        //構造函數,加載Config
        public AuthorizeGatewayFilterFactory() {
            //固定寫法
            super(AuthorizeGatewayFilterFactory.Config.class);
            log.info("Loaded GatewayFilterFactory [Authorize]");
        }
     
        //讀取配置文件中的參數 賦值到 配置類中
        @Override
        public List<String> shortcutFieldOrder() {
            //Config.enabled
            return Arrays.asList("enabled");
        }
     
        @Override
        public GatewayFilter apply(AuthorizeGatewayFilterFactory.Config config) {
            return (exchange, chain) -> {
                //判斷是否開啟授權驗證
                if (!config.isEnabled()) {
                    return chain.filter(exchange);
                }
     
                ServerHttpRequest request = exchange.getRequest();
                HttpHeaders headers = request.getHeaders();
                //從請求頭中獲取token
                String token = headers.getFirst(AUTHORIZE_TOKEN);
                if (token == null) {
                    //從請求頭參數中獲取token
                    token = request.getQueryParams().getFirst(AUTHORIZE_TOKEN);
                }
     
                ServerHttpResponse response = exchange.getResponse();
                //如果token為空,直接返回401,未授權
                if (StringUtils.isEmpty(token)) {
                    response.setStatusCode(HttpStatus.UNAUTHORIZED);
                    //處理完成,直接攔截,不再進行下去
                    return response.setComplete();
                }
                /**
                 * todo chain.filter(exchange) 之前的都是過濾器的前置處理
                 *
                 * chain.filter().then(
                 *  過濾器的后置處理...........
                 * )
                 */
                //授權正常,繼續下一個過濾器鏈的調用
                return chain.filter(exchange);
            };
        }
     
        @Data
        @AllArgsConstructor
        @NoArgsConstructor
        public static class Config {
            // 控制是否開啟認證
            private boolean enabled;
        }
    }

    局部過濾器需要在路由中配置才能生效,配置如下:

    spring:
      cloud:
        gateway:
          routes:
            - id: gateway-provider_1
              uri: http://localhost:9024
              predicates:
                - Path=/gateway/provider/**
              ## 配置過濾器(局部)
              filters:
                - AddResponseHeader=X-Response-Foo, Bar
                ## AuthorizeGatewayFilterFactory自定義過濾器配置,值為true需要驗證授權,false不需要
                - Authorize=true

    此時直接訪問:http://localhost:9023/gateway/provider/port,不攜帶token,返回如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    請求參數帶上token:http://localhost:9023/gateway/provider/port?token=abcdcdecd-ddcdeicd12,成功返回,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

            上述的 AuthorizeGatewayFilterFactory 只是涉及到了過濾器的前置處理,后置處理是在 chain.filter().then() 中的 then() 方法中完成的,具體可以看下項目源碼中的 TimeGatewayFilterFactory,代碼就不再貼出來了,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    (3)GlobalFilter 全局過濾器:

            全局過濾器應用全部路由上,無需開發者配置,Spring Cloud Gateway 也內置了一些全局過濾器,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

            GlobalFilter 的功能其實和 GatewayFilter 是相同的,只是 GlobalFilter 的作用域是所有的路由配置,而不是綁定在指定的路由配置上。多個 GlobalFilter 可以通過 @Order 或者 getOrder() 方法指定執行順序,order值越小,執行的優先級越高。

            注意,由于過濾器有 pre 和 post 兩種類型,pre 類型過濾器如果 order 值越小,那么它就應該在pre過濾器鏈的頂層,post 類型過濾器如果 order 值越小,那么它就應該在 post 過濾器鏈的底層。示意圖如下:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    (4)自定義全局過濾器:

            當然除了內置的全局過濾器,實際工作中還需要定制過濾器,下面來介紹一下如何自定義。我們模擬 Nginx 的 Access Log 功能,記錄每次請求的相關信息。代碼如下:

    @Slf4j
    @Component
    @Order(value = Integer.MIN_VALUE)
    public class AccessLogGlobalFilter implements GlobalFilter {
     
        @Override
        public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
            //filter的前置處理
            ServerHttpRequest request = exchange.getRequest();
            String path = request.getPath().pathWithinApplication().value();
            InetSocketAddress remoteAddress = request.getRemoteAddress();
            return chain
                    //繼續調用filter
                    .filter(exchange)
                    //filter的后置處理
                    .then(Mono.fromRunnable(() -> {
                ServerHttpResponse response = exchange.getResponse();
                HttpStatus statusCode = response.getStatusCode();
                log.info("請求路徑:{},遠程IP地址:{},響應碼:{}", path, remoteAddress, statusCode);
            }));
        }
    }

    好了,全局過濾器不必在路由上配置,注入到IOC容器中即可全局生效。

    此時發出一個請求,控制臺打印信息如下:

    請求路徑:/gateway/provider/port,遠程IP地址:/0:0:0:0:0:0:0:1:64114,響應碼:200 OK

    4、Gateway 集成 nacos 注冊中心實現服務發現:

            上述 demo 中并沒有集成注冊中心,每次路由配置都是指定固定的服務uri,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    這樣做有什么壞處呢?

    • 網關服務需要知道所有服務的域名或IP地址,另外,一旦服務的域名或IP地址發生修改,路由配置中的 uri 就必須修改

    • 服務集群中無法實現負載均衡

            那么此時我們可以集成的注冊中心,使得網關能夠從注冊中心自動獲取uri,并實現負載均衡,這里我們以 nacos 注冊中心為例介紹一下

    (1)pom 文件中新增依賴:

    <!--nacos注冊中心-->
    <dependency>
    	<groupId>com.alibaba.cloud</groupId>
    	<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>

    (2)啟動類添加 @EnableDiscoveryClient 注解開啟注冊中心功能,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

     (3)配置 nacos 注冊中心的地址:

    nacos:
      namespace: 856a40d7-6548-4494-bdb9-c44491865f63
      url: 120.76.129.106:80
    spring:
      cloud:
        nacos:
          discovery:
          	server-addr: ${nacos.url}
            namespace: ${nacos.namespace}
            register-enabled: true

    (4)服務路由配置:

    spring:
      cloud:
        gateway:
          routes:
            - id: gateway-provider_1
              ## 使用了lb形式,從注冊中心負載均衡的獲取uri
              uri: lb://gateway-provider
              ## 配置斷言
              predicates:
                - Path=/gateway/provider/**
              filters:
                - AddResponseHeader=X-Response-Foo, Bar

    路由配置中唯一不同的就是路由的 uri,格式:lb://service-name,這是固定寫法:

    • lb:固定格式,指的是從nacos中按照名稱獲取微服務,并遵循負載均衡策略

    • service-name:nacos注冊中心的服務名稱,這里并不是IP地址形式的

            為什么指定了 lb 就可以開啟負載均衡,前面說過全局過濾器 LoadBalancerClientFilter 就是負責路由尋址和負載均衡的,可以看到如下源碼:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    (5)開啟 gateway 自動路由配置:

            隨著我們的系統架構不斷地發展,系統中微服務的數量肯定會越來越多,我們不可能每添加一個服務,就在網關配置一個新的路由規則,這樣的維護成本很大;特別在很多種情況,我們在請求路徑中會攜帶一個路由標識方便進行轉發,而這個路由標識一般都是服務在注冊中心中的服務名,因此這是我們就可以開啟 spring cloud gateway 的自動路由功能,網關自動根據注冊中心的服務名為每個服務創建一個router,將以服務名開頭的請求路徑轉發到對應的服務,配置如下:

    # enabled:默認為false,設置為true表明spring cloud gateway開啟服務發現和路由的功能,網關自動根據注冊中心的服務名為每個服務創建一個router,將以服務名開頭的請求路徑轉發到對應的服務
    spring.cloud.gateway.discovery.locator.enabled = true
    # lowerCaseServiceId:啟動 locator.enabled=true 自動路由時,路由的路徑默認會使用大寫ID,若想要使用小寫ID,可將lowerCaseServiceId設置為true
    spring.cloud.gateway.discovery.locator.lower-case-service-id = true

            這里需要注意的是,由于我們的網關項目配置了 server.servlet.context-path 屬性,這會導致自動路由失敗的問題,因此我們需要做如下兩個修改:

    # 重寫過濾鏈,解決項目設置了 server.servlet.context-path 導致 locator.enabled=true 默認路由策略404的問題
    spring.cloud.gateway.discovery.locator.filters[0] = PreserveHostHeader
    @Configuration
    public class GatewayConfig
    {
        @Value ("${server.servlet.context-path}")
        private String prefix;
     
        /**
         * 過濾 server.servlet.context-path 屬性配置的項目路徑,防止對后續路由策略產生影響,因為 gateway 網關不支持 servlet
         */
        @Bean
        @Order (-1)
        public WebFilter apiPrefixFilter()
        {
            return (exchange, chain) ->
            {
                ServerHttpRequest request = exchange.getRequest();
                String path = request.getURI().getRawPath();
     
                path = path.startsWith(prefix) ? path.replaceFirst(prefix, "") : path;
                ServerHttpRequest newRequest = request.mutate().path(path).build();
     
                return chain.filter(exchange.mutate().request(newRequest).build());
            };
        }
    }

            至此,我們就開啟了 spring cloud gateway 的自動路由功能,網關自動根據注冊中心的服務名為每個服務創建一個router,將以服務名開頭的請求路徑轉發到對應的服務。假設我們的服務提供者在 nacos 注冊中心的服務名為 “gateway-provider”,這時我們只需要訪問 “http://localhost:9023/gateway/gateway-provider/test”,就可以將請求成功轉發過去了

    5、Gateway 整合 Apollo 實現動態路由配置:

            上述例子都是將網關的一系列配置寫到項目的配置文件中,一旦路由策略發生改變必須要重啟項目,這樣維護成本很高,特別是服務網關作為系統的中心點,一旦重啟出現問題,影響面將是十分巨大的,因此,我們將網關的配置存放到配置中心中,這樣由配置中心統一管理,一旦路由發生改變,只需要在配置中心修改即可,降低風險且實時失效。本部分就以 Apollo 配置中心為例介紹下如下實現動態路由配置:

    (1)添加 apollo 配置中心依賴:

    <!-- Apollo 統一配置中心 -->
    <dependency>
        <groupId>com.ctrip.framework.apollo</groupId>
        <artifactId>apollo-client</artifactId>
        <version>1.7.0</version>
    </dependency>

    (2)添加 Apollo 路由更改監聽刷新類:

    import com.ctrip.framework.apollo.enums.PropertyChangeType;
    import com.ctrip.framework.apollo.model.ConfigChange;
    import com.ctrip.framework.apollo.model.ConfigChangeEvent;
    import com.ctrip.framework.apollo.spring.annotation.ApolloConfigChangeListener;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.beans.BeansException;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.cloud.context.environment.EnvironmentChangeEvent;
    import org.springframework.cloud.gateway.config.GatewayProperties;
    import org.springframework.cloud.gateway.event.RefreshRoutesEvent;
    import org.springframework.cloud.gateway.route.RouteDefinitionWriter;
    import org.springframework.context.ApplicationContext;
    import org.springframework.context.ApplicationContextAware;
    import org.springframework.context.ApplicationEventPublisher;
    import org.springframework.context.ApplicationEventPublisherAware;
    import org.springframework.context.annotation.Configuration;
     
    import java.util.ArrayList;
     
    /**
     * Apollo路由更改監聽刷新
     */
    @Configuration
    public class GatewayPropertRefresher implements ApplicationContextAware, ApplicationEventPublisherAware
    {
        private static final Logger logger = LoggerFactory.getLogger(GatewayPropertRefresher.class);
     
        private static final String ID_PATTERN = "spring\\.cloud\\.gateway\\.routes\\[\\d+\\]\\.id";
     
        private static final String DEFAULT_FILTER_PATTERN = "spring\\.cloud\\.gateway\\.default-filters\\[\\d+\\]\\.name";
     
     
        private ApplicationContext applicationContext;
     
        private ApplicationEventPublisher publisher;
     
        @Autowired
        private  GatewayProperties gatewayProperties;
     
        @Autowired
        private RouteDefinitionWriter routeDefinitionWriter;
     
     
        @Override
        public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
            this.applicationContext = applicationContext;
        }
     
        @Override
        public void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher) {
            this.publisher = applicationEventPublisher;
        }
     
     
        /**
         * 監聽路由修改
         */
        @ApolloConfigChangeListener(interestedKeyPrefixes = "spring.cloud.gateway.")
        public void onChange(ConfigChangeEvent changeEvent)
        {
            refreshGatewayProperties(changeEvent);
        }
     
        /**
         * 刷新路由信息
         */
        private void refreshGatewayProperties(ConfigChangeEvent changeEvent)
        {
            logger.info("gateway網關配置 刷新開始!");
     
            preDestroyGatewayProperties(changeEvent);
            //更新配置
            this.applicationContext.publishEvent(new EnvironmentChangeEvent(changeEvent.changedKeys()));
            //更新路由
            refreshGatewayRouteDefinition();
     
            logger.info("gateway網關配置 刷新完成!");
        }
     
        /***
         * GatewayProperties沒有@PreDestroy和destroy方法
         * org.springframework.cloud.context.properties.ConfigurationPropertiesRebinder#rebind(java.lang.String)中destroyBean時不會銷毀當前對象
         * 如果把spring.cloud.gateway.前綴的配置項全部刪除(例如需要動態刪除最后一個路由的場景),initializeBean時也無法創建新的bean,則return當前bean
         * 若仍保留有spring.cloud.gateway.routes[n]或spring.cloud.gateway.default-filters[n]等配置,initializeBean時會注入新的屬性替換已有的bean
         * 這個方法提供了類似@PreDestroy的操作,根據配置文件的實際情況把org.springframework.cloud.gateway.config.GatewayProperties#routes
         * 和org.springframework.cloud.gateway.config.GatewayProperties#defaultFilters兩個集合清空
         */
        private synchronized void preDestroyGatewayProperties(ConfigChangeEvent changeEvent)
        {
            logger.info("Pre Destroy GatewayProperties 操作開始!");
     
            final boolean needClearRoutes = this.checkNeedClear(changeEvent, ID_PATTERN, this.gatewayProperties.getRoutes().size());
            if (needClearRoutes)
            {
                this.gatewayProperties.setRoutes(new ArrayList());
            }
     
            final boolean needClearDefaultFilters = this.checkNeedClear(changeEvent, DEFAULT_FILTER_PATTERN, this.gatewayProperties.getDefaultFilters().size());
            if (needClearDefaultFilters)
            {
                this.gatewayProperties.setRoutes(new ArrayList());
            }
     
            logger.info("Pre Destroy GatewayProperties 操作完成!");
        }
     
     
        private void refreshGatewayRouteDefinition()
        {
            logger.info("Refreshing Gateway RouteDefinition 操作開始!");
     
            this.publisher.publishEvent(new RefreshRoutesEvent(this));
     
            logger.info("Gateway RouteDefinition refreshed 操作完成!");
        }
     
        /***
         * 根據changeEvent和定義的pattern匹配key,如果所有對應PropertyChangeType為DELETED則需要清空GatewayProperties里相關集合
         */
        private boolean checkNeedClear(ConfigChangeEvent changeEvent, String pattern, int existSize) {
     
            return changeEvent.changedKeys().stream().filter(key -> key.matches(pattern)).filter(key ->
            {
                ConfigChange change = changeEvent.getChange(key);
                return PropertyChangeType.DELETED.equals(change.getChangeType());
            }).count() == existSize;
        }
    }

    (3)暴露endpoint端點:

    # 暴露endpoint端點,暴露路由信息,有獲取所有路由、刷新路由、查看單個路由、刪除路由等方法
    management.endpoints.web.exposure.include = *
    management.endpoint.health.show-details = always

            至此,我們就完成了 Gateway 網關整合 Apollo 配置中心實現動態路由配置,一旦路由發生改變,只需要在配置中心修改即可被監聽到并實時失效

    6、自定義全局異常處理器:

            通過前面的測試可以看到一個現象:一旦路由的微服務下線或者失聯了,Spring Cloud Gateway直接返回了一個錯誤頁面,如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

            顯然這種異常信息不友好,前后端分離架構中必須定制返回的異常信息。傳統的Spring Boot 服務中都是使用 @ControllerAdvice 來包裝全局異常處理的,但是由于服務下線,請求并沒有到達。因此必須在網關中也要定制一層全局異常處理,這樣才能更加友好的和客戶端交互。

            Spring Cloud Gateway提供了多種全局處理的方式,今天只介紹其中一種方式,實現還算比較優雅:

            直接創建一個類 GlobalErrorExceptionHandler,實現 ErrorWebExceptionHandler,重寫其中的 handle 方法,代碼如下:

    /**
     * 用于網關的全局異常處理
     * @Order(-1):優先級一定要比ResponseStatusExceptionHandler低
     */
    @Slf4j
    @Order(-1)
    @Component
    @RequiredArgsConstructor
    public class GlobalErrorExceptionHandler implements ErrorWebExceptionHandler {
     
     private final ObjectMapper objectMapper;
     
     @SuppressWarnings({"rawtypes", "unchecked", "NullableProblems"})
     @Override
     public Mono<Void> handle(ServerWebExchange exchange, Throwable ex) {
      ServerHttpResponse response = exchange.getResponse();
      if (response.isCommitted()) {
       return Mono.error(ex);
      }
     
      // JOSN格式返回
      response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
      if (ex instanceof ResponseStatusException) {
       response.setStatusCode(((ResponseStatusException) ex).getStatus());
      }
     
      return response.writeWith(Mono.fromSupplier(() -> {
       DataBufferFactory bufferFactory = response.bufferFactory();
       try {
        //todo 返回響應結果,根據業務需求,自己定制
        CommonResponse resultMsg = new CommonResponse("500",ex.getMessage(),null);
        return bufferFactory.wrap(objectMapper.writeValueAsBytes(resultMsg));
       }
       catch (JsonProcessingException e) {
        log.error("Error writing response", ex);
        return bufferFactory.wrap(new byte[0]);
       }
      }));
     }
    }

            好了,全局異常處理已經定制完成了,在測試一下,此時正常返回JSON數據了(JSON的樣式根據架構需要自己定制),如下圖:

    SpringCloud?Gateway服務網關的部署與使用的方法是什么

    關于“SpringCloud Gateway服務網關的部署與使用的方法是什么”的內容就介紹到這里了,感謝大家的閱讀。如果想了解更多行業相關的知識,可以關注億速云行業資訊頻道,小編每天都會為大家更新不同的知識點。

    向AI問一下細節

    免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。

    AI

    长垣县| 常州市| 南投市| 子长县| 松滋市| 宁陕县| 巴彦县| 离岛区| 同江市| 邹城市| 青龙| 镇沅| 福海县| 巍山| 达日县| 巩留县| 南投县| 文化| 昌平区| 左云县| 香港| 安康市| 莎车县| 华池县| 衡南县| 深泽县| 马尔康县| 浠水县| 乾安县| 正宁县| 磐安县| 岗巴县| 乌兰浩特市| 泊头市| 兴义市| 容城县| 中江县| 琼结县| 石家庄市| 霍邱县| 肥城市|