锋哥原创的微服务网关Gateway视频教程:
4.1 路由断言工厂
Spring Cloud Gateway将路由作为Spring WebFluxHandlerMapping
基础架构的一部分进行匹配。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
路由断言厂有两个参数:春天的列表PathMatcher
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。