四：Gateway路由规则

Gateway路由规则

4.1 路由断言工厂

　　Spring Cloud Gateway将路由作为Spring WebFlux HandlerMapping 基础架构的一部分进行匹 配。Spring Cloud Gateway包括许多内置的路由断言工厂。所有这些断言都与HTTP请求的不同属性匹 配。您可以将多个路由断言工厂与逻辑 and 语句结合使用。

　　路由断言工厂RoutePredicateFactory包含的主要实现类如图所示，包含Datetime、Cookie、Header、Host、Method、Path、Query、RemoteAddr、Weight等类型的路由断言。

 

 

4.2 日期时间路由匹配规则 

　　匹配指定日期时间之后的请求 After

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: after_route
         uri: http://localhost:8080/
         predicates:
          - After=2021-04-20T06:06:06+08:00[Asia/Shanghai]

 

　　匹配指定日期时间之前的请求 Before

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: before_route
         uri: http://localhost:8080/
         predicates:
          - Before=2021-04-20T06:06:06+08:00[Asia/Shanghai]

 

　　匹配指定日期时间之间的请求 Between

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: betwwen_route
         uri: http://localhost:8080/
         predicates:
          - Between=2021-01-20T06:06:06+08:00[Asia/Shanghai],2021-04-
20T06:06:06+08:00[Asia/Shanghai]

 

4.3 Cookie路由匹配规则

　　所述Cookie路由断言工厂采用两个参数，该cookiename和regexp(其是Java正则表达式)。该断言匹 配具有给定名称且其值与正则表达式匹配的cookie。以下示例配置cookie路由断言工厂:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: cookie_route
         uri: http://localhost:8080/
         predicates:
          - Cookie=token, \d+

 

4.4 Header路由匹配规则

　　所述 Header ;路由断言工厂采用两个参数，报头 name 和一个 regexp (其是Java正则表达式)。该断言与具有给定名称的头信息匹配，该标头的值与正则表达式匹配。以下示例配置Header路由断言:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: header_route
         uri: http://localhost:8080/
         predicates:
          - Header=X-Request-Id, \d+

 

4.5 Host路由匹配规则

　　该 Host 路由断言工厂需要一个参数:主机名的列表 patterns 。该模式是带有.分隔符的Ant样式的模式。断言与 Host 匹配模式的标头匹配。以下示例配置主机路由断言:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: host_route
         uri: http://localhost:8080/
         predicates:
          - Host=**.somehost.org,**.anotherhost.org

 

4.6 Method路由匹配规则

　　所述 Method 路由断言厂需要 methods 的参数，它是一个或多个参数:HTTP方法来匹配。以下示例配置 方法路由断言:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: method_route
         uri: http://localhost:8080/
         predicates:
          - Method=GET,POST

 

4.7 Path路由匹配规则

　　该 Path 路由断言厂有两个参数:春天的列表 patterns 和一个可选的标志叫matchOptionalTrailingSeparator 。以下示例配置路径路由断言:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: path_route
         uri: http://localhost:8080/
         predicates:
          - Path=/product/{segment}

 

4.8 Query路由匹配规则　　

　　所述 Query 路由断言工厂采用两个参数:所要求的 param 和可选的 regexp (其是Java正则表达式)。

以下示例配置查询路由断言:

spring:
  application:
    name: gateway-server
  cloud:
    gateway:
      routes:
       - id: query_route
         uri: http://localhost:8080/
         predicates:
          - Query=green

 

如果请求包含 green 查询参数，则前面的路由匹配。

 

4.9 RemoteAddr路由匹配规则

所述 RemoteAddr 路由断言工厂需要的列表(分钟尺寸1) sources ，其是CIDR的表示法(IPv4或 IPv6)的字符串，如 192.168.0.1/16 (其中 192.168.0.1 是一个IP地址和 16 一个子网掩码)。下面 的示例配置RemoteAddr路由断言:

spring:
  cloud:
    gateway:
      routes:
      - id: remoteaddr_route
        uri: https://example.org
        predicates:
        - RemoteAddr=192.168.1.1/24

 

如果请求的远程地址为上面配置，则此路由匹配192.168.1.10。 

4.10 Weight路由匹配规则

　　该 Weight 路由断言工厂有两个参数: group 和 weight (一个int)。权重是按组计算的。以下示例配 置权重路由断言:

spring:
  cloud:
    gateway:
      routes:
      - id: weight_high
        uri: https://weighthigh.org
        predicates:
        - Weight=group1, 8
      - id: weight_low
        uri: https://weightlow.org
        predicates:
        - Weight=group1, 2

 

　　这条路线会将大约80%的流量转发到weighthigh.org，将大约20%的流量转发到weightlow.org。