（十三）、GateWay路由閘道器

阿新 • • 發佈：2021-10-01

GateWay是什麼

上一代zuul 1.x官網

Gateway官網

概述

Cloud全家桶中有個很重要的元件就是閘道器，在1.x版本中都是採用的Zuul閘道器;

但在2.x版本中，zuul的升級一直跳票，SpringCloud最後自己研發了一個閘道器替代Zuul，那就是SpringCloud Gateway—句話：gateway是原zuul1.x版的替代

Gateway是在Spring生態系統之上構建的API閘道器服務，基於Spring 5，Spring Boot 2和Project Reactor等技術。

Gateway旨在提供一種簡單而有效的方式來對API進行路由，以及提供一些強大的過濾器功能，例如:熔斷、限流、重試等。

SpringCloud Gateway是Spring Cloud的一個全新專案，基於Spring 5.0+Spring Boot 2.0和Project Reactor等技術開發的閘道器，它旨在為微服務架構提供—種簡單有效的統一的API路由管理方式。

SpringCloud Gateway作為Spring Cloud 生態系統中的閘道器，目標是替代Zuul，在Spring Cloud 2.0以上版本中，沒有對新版本的Zul 2.0以上最新高效能版本進行整合，仍然還是使用的Zuul 1.x非Reactor模式的老版本。而為了提升閘道器的效能，SpringCloud Gateway是基於WebFlux框架實現的，而WebFlux框架底層則使用了高效能的Reactor模式通訊框架Netty。

Spring Cloud Gateway的目標提供統一的路由方式且基於 Filter鏈的方式提供了閘道器基本的功能，例如:安全，監控/指標，和限流。

作用

方向代理
鑑權
流量控制
熔斷
日誌監控

微服務架構中閘道器的位置

GateWay非阻塞非同步模型

有Zuull了怎麼又出來Gateway？我們為什麼選擇Gateway?

1.netflix不太靠譜，zuul2.0一直跳票，遲遲不釋出。

一方面因為Zuul1.0已經進入了維護階段，而且Gateway是SpringCloud團隊研發的，是親兒子產品，值得信賴。而且很多功能Zuul都沒有用起來也非常的簡單便捷。
Gateway是基於非同步非阻塞模型上進行開發的，效能方面不需要擔心。雖然Netflix早就釋出了最新的Zuul 2.x，但Spring Cloud貌似沒有整合計劃。而且Netflix相關元件都宣佈進入維護期；不知前景如何?
多方面綜合考慮Gateway是很理想的閘道器選擇。

2.SpringCloud Gateway具有如下特性

基於Spring Framework 5，Project Reactor和Spring Boot 2.0進行構建；
動態路由：能夠匹配任何請求屬性；
可以對路由指定Predicate (斷言)和Filter(過濾器)；
整合Hystrix的斷路器功能；
整合Spring Cloud 服務發現功能；
易於編寫的Predicate (斷言)和Filter (過濾器)；
請求限流功能；
支援路徑重寫。

3.SpringCloud Gateway與Zuul的區別

在SpringCloud Finchley正式版之前，Spring Cloud推薦的閘道器是Netflix提供的Zuul。
Zuul 1.x，是一個基於阻塞I/O的API Gateway。
Zuul 1.x基於Servlet 2.5使用阻塞架構它不支援任何長連線(如WebSocket)Zuul的設計模式和Nginx較像，每次I/О操作都是從工作執行緒中選擇一個執行，請求執行緒被阻塞到工作執行緒完成，但是差別是Nginx用C++實現，Zuul用Java實現，而JVM本身會有第-次載入較慢的情況，使得Zuul的效能相對較差。
Zuul 2.x理念更先進，想基於Netty非阻塞和支援長連線，但SpringCloud目前還沒有整合。Zuul .x的效能較Zuul 1.x有較大提升。在效能方面，根據官方提供的基準測試,Spring Cloud Gateway的RPS(每秒請求數)是Zuul的1.6倍。
Spring Cloud Gateway建立在Spring Framework 5、Project Reactor和Spring Boot2之上，使用非阻塞API。
Spring Cloud Gateway還支援WebSocket，並且與Spring緊密整合擁有更好的開發體驗

Zuul1.x模型

Springcloud中所整合的Zuul版本，採用的是Tomcat容器，使用的是傳統的Serviet IO處理模型。

Servlet的生命週期？servlet由servlet container進行生命週期管理。

container啟動時構造servlet物件並呼叫servlet init()進行初始化；
container執行時接受請求，併為每個請求分配一個執行緒（一般從執行緒池中獲取空閒執行緒）然後呼叫service)；
container關閉時呼叫servlet destory()銷燬servlet。

上述模式的缺點：

Servlet是一個簡單的網路IO模型，當請求進入Servlet container時，Servlet container就會為其繫結一個執行緒，在併發不高的場景下這種模型是適用的。但是一旦高併發(如抽風用Jmeter壓)，執行緒數量就會上漲，而執行緒資源代價是昂貴的（上線文切換，記憶體消耗大）嚴重影響請求的處理時間。在一些簡單業務場景下，不希望為每個request分配一個執行緒，只需要1個或幾個執行緒就能應對極大併發的請求，這種業務場景下servlet模型沒有優勢。

所以Zuul 1.X是基於servlet之上的一個阻塞式處理模型，即Spring實現了處理所有request請求的一個servlet (DispatcherServlet)並由該servlet阻塞式處理處理。所以SpringCloud Zuul無法擺脫servlet模型的弊端。

Gateway模型

WebFlux是什麼？官方文件

傳統的Web框架，比如說: Struts2，SpringMVC等都是基於Servlet APl與Servlet容器基礎之上執行的。

但是在Servlet3.1之後有了非同步非阻塞的支援。而WebFlux是一個典型非阻塞非同步的框架，它的核心是基於Reactor的相關API實現的。相對於傳統的web框架來說，它可以執行在諸如Netty，Undertow及支援Servlet3.1的容器上。非阻塞式+函數語言程式設計(Spring 5必須讓你使用Java 8)。

Spring WebFlux是Spring 5.0 引入的新的響應式框架，區別於Spring MVC，它不需要依賴Servlet APl，它是完全非同步非阻塞的，並且基於Reactor來實現響應式流規範。

Gateway工作流程

三大核心概念

Route(路由) - 路由是構建閘道器的基本模組,它由ID,目標URI,一系列的斷言和過濾器組成,如斷言為true則匹配該路由；
Predicate(斷言) - 參考的是Java8的java.util.function.Predicate，開發人員可以匹配HTTP請求中的所有內容(例如請求頭或請求引數),如果請求與斷言相匹配則進行路由；
Filter(過濾) - 指的是Spring框架中GatewayFilter的例項,使用過濾器,可以在請求被路由前或者之後對請求進行修改。

web請求，通過一些匹配條件，定位到真正的服務節點。並在這個轉發過程的前後，進行一些精細化控制。

predicate就是我們的匹配條件；而fliter，就可以理解為一個無所不能的攔截器。有了這兩個元素，再加上目標uri，就可以實現一個具體的路由了

Gateway工作流程

官網總結

客戶端向Spring Cloud Gateway發出請求。然後在Gateway Handler Mapping 中找到與請求相匹配的路由，將其傳送到GatewayWeb Handler。

Handler再通過指定的過濾器鏈來將請求傳送到我們實際的服務執行業務邏輯，然後返回。

過濾器之間用虛線分開是因為過濾器可能會在傳送代理請求之前(“pre”)或之後(“post"）執行業務邏輯。

Filter在“pre”型別的過濾器可以做引數校驗、許可權校驗、流量監控、日誌輸出、協議轉換等，在“post”型別的過濾器中可以做響應內容、響應頭的修改，日誌的輸出，流量監控等有著非常重要的作用。

核心邏輯：路由轉發 + 執行過濾器鏈。

Gateway9527搭建

1.新建Module - cloud-gateway-gateway9527

2.POM

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>cloud2021</artifactId>
        <groupId>com.ylc.cloud</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>cloud-gateway-gateway9527</artifactId>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <dependencies>
        <!--gateway-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
        <!--eureka-client-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <!-- 引入自己定義的api通用包，可以使用Payment支付Entity -->
        <dependency>
            <groupId>com.ylc.cloud</groupId>
            <artifactId>cloud-api-commons</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <!--一般基礎配置類-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

3.YML

server:
  port: 9527

spring:
  application:
    name: cloud-gateway


eureka:
  instance:
    hostname: cloud-gateway-service
  client: #服務提供者provider註冊進eureka服務列表內
    service-url:
      register-with-eureka: true
      fetch-registry: true
      defaultZone: http://eureka7001.com:7001/eureka

4.主啟動類

package com.ylc.cloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;


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

5.9527閘道器如何做路由對映?

cloud-provider-payment8001中controller方法，目前不想暴露8001埠，希望在8001外面套一層9527

6.YML新增閘道器配置

server:
  port: 9527

spring:
  application:
    name: cloud-gateway

#############################新增閘道器配置###########################
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID，沒有固定規則但要求唯一，建議配合服務名
          uri: http://localhost:8001          #匹配後提供服務的路由地址
          #uri: lb://cloud-payment-service #匹配後提供服務的路由地址
          predicates:
            - Path=/payment/get/**         # 斷言，路徑相匹配的進行路由

        - id: payment_routh2 #payment_route    #路由的ID，沒有固定規則但要求唯一，建議配合服務名
          uri: http://localhost:8001          #匹配後提供服務的路由地址
          #uri: lb://cloud-payment-service #匹配後提供服務的路由地址
          predicates:
            - Path=/payment/lb/**         # 斷言，路徑相匹配的進行路由
####################################################################

eureka:
  instance:
    hostname: cloud-gateway-service
  client: #服務提供者provider註冊進eureka服務列表內
    service-url:
      register-with-eureka: true
      fetch-registry: true
      defaultZone: http://eureka7001.com:7001/eureka

8.測試

啟動7001、啟動8001-cloud-provider-payment8001、啟動9527閘道器

訪問說明

新增閘道器前 - http://localhost:8001/payment/get/1
新增閘道器後 - http://localhost:9527/payment/get/1
兩者訪問成功，返回相同結果

Gateway配置路由的兩種方式

程式碼中注入RouteLocator的Bean

官方案例 - https://cloud.spring.io/spring-cloud-static/spring-cloud-gateway/2.2.1.RELEASE/reference/html/#modifying-the-way-remote-addresses-are-resolved

業務需求 - 通過9527閘道器訪問到外網的百度新聞網址

編碼

cloud-gateway-gateway9527業務實現

package config;

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class GateWayConfig
{
    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder routeLocatorBuilder)
    {
        RouteLocatorBuilder.Builder routes = routeLocatorBuilder.routes();

        routes.route("path_route_atguigu",
                r -> r.path("/guonei")
                        .uri("http://news.baidu.com/guonei")).build();

        return routes.build();
    }
}

測試

瀏覽器輸入http://localhost:9527/guonei，返回http://news.baidu.com/guonei相同的頁面。

GateWay配置動態路由

預設情況下Gateway會根據註冊中心註冊的服務列表，以註冊中心上微服務名為路徑建立動態路由進行轉發，從而實現動態路由的功能（不寫死一個地址）。

啟動

eureka7001
payment8001/8002

YML

需要注意的是uri的協議為lb，表示啟用Gateway的負載均衡功能。

lb://serviceName是spring cloud gateway在微服務中自動為我們建立的負載均衡uri。

server:
  port: 9527

spring:
  application:
    name: cloud-gateway

#############################新增閘道器配置###########################
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID，沒有固定規則但要求唯一，建議配合服務名
          #uri: http://localhost:8001          #匹配後提供服務的路由地址
          uri: lb://cloud-payment-service #匹配後提供服務的路由地址
          predicates:
            - Path=/payment/get/**         # 斷言，路徑相匹配的進行路由

        - id: payment_routh2 #payment_route    #路由的ID，沒有固定規則但要求唯一，建議配合服務名
          #uri: http://localhost:8001          #匹配後提供服務的路由地址
          uri: lb://cloud-payment-service #匹配後提供服務的路由地址
          predicates:
            - Path=/payment/lb/**         # 斷言，路徑相匹配的進行路由
####################################################################

eureka:
  instance:
    hostname: cloud-gateway-service
  client: #服務提供者provider註冊進eureka服務列表內
    service-url:
      register-with-eureka: true
      fetch-registry: true
      defaultZone: http://eureka7001.com:7001/eureka

測試

瀏覽器輸入 - http://localhost:9527/payment/lb

結果

不停重新整理頁面，8001/8002兩個埠切換。

GateWay常用的Predicate

官方文件

Route Predicate Factories這個是什麼

Spring Cloud Gateway將路由匹配作為Spring WebFlux HandlerMapping基礎架構的一部分。

Spring Cloud Gateway包括許多內建的Route Predicate工廠。所有這些Predicate都與HTTP請求的不同屬性匹配。多個RoutePredicate工廠可以進行組合。

Spring Cloud Gateway建立Route 物件時，使用RoutePredicateFactory 建立 Predicate物件，Predicate 物件可以賦值給Route。Spring Cloud Gateway包含許多內建的Route Predicate Factories。
所有這些謂詞都匹配HTTP請求的不同屬性。多種謂詞工廠可以組合，並通過邏輯and。

常用的Route Predicate Factory

The After Route Predicate Factory
The Before Route Predicate Factory
The Between Route Predicate Factory
The Cookie Route Predicate Factory
The Header Route Predicate Factory
The Host Route Predicate Factory
The Method Route Predicate Factory
The Path Route Predicate Factory
The Query Route Predicate Factory
The RemoteAddr Route Predicate Factory
The weight Route Predicate Factory

討論幾個Route Predicate Factory

The After Route Predicate Factory

spring:
  cloud:
    gateway:
      routes:
      - id: after_route
        uri: https://example.org
        predicates:
        # 這個時間後才能起效
        - After=2017-01-20T17:42:47.789-07:00[America/Denver]

可以通過下述方法獲得上述格式的時間戳字串

import java.time.ZonedDateTime;

public class T2
{
    public static void main(String[] args)
    {
        ZonedDateTime zbj = ZonedDateTime.now(); // 預設時區
        System.out.println(zbj);

       //2021-02-22T15:51:37.485+08:00[Asia/Shanghai]
    }
}

The Between Route Predicate Factory

spring:
  cloud:
    gateway:
      routes:
      - id: between_route
        uri: https://example.org
        # 兩個時間點之間
        predicates:
        - Between=2017-01-20T17:42:47.789-07:00[America/Denver], 2017-01-21T17:42:47.789-07:00[America/Denver]

The Cookie Route Predicate Factory

帶cookie訪問、鍵值對

spring:
  cloud:
    gateway:
      routes:
      - id: cookie_route
        uri: lb://cloud-payment-service
        predicates:
        - Cookie=chocolate,chip

測試

# 該命令相當於發get請求，且沒帶cookie
curl http://localhost:9527/payment/lb

# 帶cookie的
curl http://localhost:9527/payment/lb --cookie "chocolate=chip"

The Header Route Predicate Factory

spring:
  cloud:
    gateway:
      routes:
      - id: header_route
        uri: lb://cloud-payment-service
        predicates:
         - Header=X-Request-Id,123

測試

# 帶指定請求頭的引數的CURL命令
curl http://localhost:9527/payment/lb -H "X-Request-Id:123"

說白了，Predicate就是為了實現一組匹配規則，讓請求過來找到對應的Route進行處理。

GateWay的Filter

官方文件

路由過濾器可用於修改進入的HTTP請求和返回的HTTP響應，路由過濾器只能指定路由進行使用。Spring Cloud Gateway內建了多種路由過濾器，他們都由GatewayFilter的工廠類來產生。

Spring Cloud Gateway的Filter:

生命週期：
- pre
- post
種類（具體看官方文件）：
- GatewayFilter - 有31種
- GlobalFilter - 有10種

常用的GatewayFilter：AddRequestParameter GatewayFilter

自定義全域性GlobalFilter：

兩個主要介面介紹：

GlobalFilter
Ordered

能幹什麼：

全域性日誌記錄
統一閘道器鑑權
…

程式碼案例：

GateWay9527專案新增MyLogGateWayFilter類：

package com.ylc.cloud.fifter;

import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.Ordered;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

import java.util.Date;

@Component
@Slf4j
public class MyLogGateWayFilter implements GlobalFilter,Ordered
{
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain)
    {
        log.info("***********come in MyLogGateWayFilter:  "+new Date());
        String uname = exchange.getRequest().getQueryParams().getFirst("uname");
        if(uname == null)
        {
            log.info("*******使用者名稱為null，非法使用者，o(╥﹏╥)o");
            exchange.getResponse().setStatusCode(HttpStatus.NOT_ACCEPTABLE);
            return exchange.getResponse().setComplete();
        }
        return chain.filter(exchange);
    }

    @Override
    public int getOrder()
    {
        return 0;
    }
}

啟動：

EurekaMain7001
PaymentMain8001
GateWayMain9527
PaymentMain8002

瀏覽器輸入：

http://localhost:9527/payment/lb - 反問異常
http://localhost:9527/payment/lb?uname=abc - 正常反問

（十三）、GateWay路由閘道器

GateWay是什麼

GateWay非阻塞非同步模型

Gateway工作流程

Gateway9527搭建

Gateway配置路由的兩種方式

GateWay配置動態路由

GateWay常用的Predicate

GateWay的Filter

（十三）、GateWay路由閘道器

ABP VNext框架基礎知識介紹（2）--微服務的閘道器

豬齒魚的微服務之路（二）：微服務閘道器

SpringCloud（十）——路由閘道器元件：Gateway

SpringCloud（4） - Zuul路由閘道器

SpringCloud（十）——路由閘道器元件：zuul

SpringCloud GateWay 使用閘道器路由

SpringCloud路由閘道器Zuul與Ribbon

springcloud教程之zuul路由閘道器的實現

Spring Cloud Zuul路由閘道器服務過濾實現程式碼

SpringCloud中使用Zuul實現路由閘道器

SpringCloud07-Zuul 路由閘道器

springCloud之路API路由閘道器Zuul

SpringCloud教程 | 第五篇: 路由閘道器(zuul)(Finchley版本)

Gateway服務閘道器

SpringCloud09：Zuul路由閘道器

Spring Cloud Gateway---服務化閘道器服務

java Feign遠端呼叫，跳過閘道器gateway，閘道器資料丟失bug

Spring Cloud Alibaba 06：Gateway服務閘道器

SpringCloud—Zuul路由閘道器

（十三）、GateWay路由閘道器

GateWay是什麼

GateWay非阻塞非同步模型

Gateway工作流程

Gateway9527搭建

Gateway配置路由的兩種方式

GateWay配置動態路由

GateWay常用的Predicate

GateWay的Filter

相關推薦